本文详解在 Go 中处理「JSON 内含已转义 JSON 字符串」的典型场景，通过两阶段反序列化将嵌套的 JSON 字符串（如 "stats": "{\"id\":545,...}"）安全、准确地解析为结构体字段，避免手动字符串处理或 json.RawMessage 的误用风险。
本文详解在 go 中处理「json 内含已转义 json 字符串」的典型场景，通过两阶段反序列化将嵌套的 json 字符串（如 `"stats": "{\"id\":545,...}"`）安全、准确地解析为结构体字段，避免手动字符串处理或 `json.rawmessage` 的误用风险。
在实际对接第三方 API 时，常会遇到一种“嵌套 JSON 字符串”结构：外层 JSON 的某个字段（如 stats）并非原始值，而是经过 JSON 编码并转义后的字符串——即其值本身是合法 JSON，但被包裹在双引号中、特殊字符（如 "、\）已被转义。若直接将其映射为结构体字段，Go 的 json.Unmarshal 会将其作为普通字符串保留，无法自动展开为结构体。
最可靠、清晰且符合 Go 惯例的解决方案是 两阶段反序列化（Two-Phase Unmarshaling）：
- 第一阶段：先将整个 JSON 解析为一个中间结构体，其中 stats 字段声明为 string 类型；
- 第二阶段：对每个 stats 字符串调用 json.Unmarshal，将其进一步解析为目标结构体。
下面是一个完整、可运行的示例：
package main
import (
"encoding/json"
"fmt"
"time"
)
// Stats 是嵌套在 stats 字符串中的真实结构
type Stats struct {
ID int `json:"id"`
LastUpdated time.Time `json:"lastUpdated"`
All struct {
Runs struct {
Count int `json:"count"`
} `json:"runs"`
} `json:"all"`
}
// RunStatus 是顶层结构（注意：stats 字段暂为 string）
type RunStatus struct {
Duration string `json:"duration"`
StartTime time.Time `json:"startTime"`
Total int `json:"total"`
Content []struct {
DateCreated time.Time `json:"dateCreated"`
LastUpdated time.Time `json:"lastUpdated"`
Name string `json:"name"` // 注意：原问题中字段名小写，但 JSON key 是驼峰，应匹配
Stats string `json:"stats"` // 先存为字符串
} `json:"content"`
}
func main() {
jsonData := `{
"duration": "126.61ms",
"startTime": "2016-02-19T20:01:17.884Z",
"total": 123,
"content": [{
"dateCreated": "2016-02-19T20:01:09.181Z",
"lastUpdated": "2016-02-19T20:01:09.181Z",
"name": "name",
"stats": "{\"id\":545,\"lastUpdated\":\"2015-01-09T19:16:04.535Z\",\"all\":{\"runs\":{\"count\":123}}}"
}]
}`
var rs RunStatus
if err := json.Unmarshal([]byte(jsonData), &rs); err != nil {
panic(err)
}
// 第二阶段：逐个解析 stats 字符串
for i := range rs.Content {
var stats Stats
if err := json.Unmarshal([]byte(rs.Content[i].Stats), &stats); err != nil {
fmt.Printf("failed to unmarshal stats[%d]: %v\n", i, err)
continue
}
fmt.Printf("Item %d: ID=%d, Runs.Count=%d\n", i, stats.ID, stats.All.Runs.Count)
}
}
✅ 关键注意事项：
- 字段命名需严格匹配 JSON Key：Go 结构体字段必须导出（首字母大写），且 json tag 必须与原始 JSON 键完全一致（如 "name" → Name string \json:"name"``）；
- 避免使用 json.RawMessage 直接嵌套：虽然可行，但会延迟解析、增加内存占用，且无法在结构体层面做类型约束和验证；
- 错误处理不可省略：嵌套 JSON 字符串可能格式错误或缺失字段，务必检查 json.Unmarshal 返回的 err；
- 性能考量：若数据量极大（如数万条），可考虑复用 *bytes.Buffer 或预分配 []byte，但对常规 API 响应无需过度优化。
总结而言，两阶段反序列化不是权宜之计，而是 Go 处理此类“JSON-in-String”模式的标准实践——它语义清晰、调试友好、类型安全，并与标准库设计哲学高度一致。
