解析嵌套转义 JSON 字符串方法详解

本文深入解析了 Go 语言中处理“JSON 内含已转义 JSON 字符串”这一常见而棘手的场景——例如第三方 API 返回的 `stats` 字段实际是经过 JSON 编码并双重转义的字符串（如 `"\"{\\\"id\\\":545,...}\""`），直接反序列化无法自动展开为结构体。文章提出并详解了业界推荐的两阶段反序列化方案：先将外层 JSON 安全解析为中间结构（嵌套字段暂存为 string），再对每个字符串单独调用 `json.Unmarshal` 进行二次解析，既规避了手动字符串拼接、`json.RawMessage` 误用等陷阱，又保障了类型安全、错误可控与调试友好，堪称 Go 生态中应对嵌套 JSON 字符串的标准实践。

本文详解在 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）：

1. 第一阶段：先将整个 JSON 解析为一个中间结构体，其中 stats 字段声明为 string 类型；
2. 第二阶段：对每个 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”模式的标准实践——它语义清晰、调试友好、类型安全，并与标准库设计哲学高度一致。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《解析嵌套转义 JSON 字符串方法详解》文章吧，也可关注golang学习网公众号了解相关技术文章。