如何在 Golang 中解析具有嵌套结构的 JSON 字符串-Golang-PHP中文网

go 的 json.unmarshal 无硬性嵌套深度限制，解析失败主因是结构体字段类型或标签与 json 不匹配。需确保字段导出、json tag 精确对应、嵌套层级一致，并善用 map[string]interface{}、json.rawmessage 或自定义 unmarshaljson 处理动态或异构场景。

如何在 golang 中解析具有嵌套结构的 json 字符串

用 `json.Unmarshal` 处理嵌套结构最直接

Go 的标准库 json 包能原生支持任意深度的嵌套，关键不是“能不能”，而是“怎么定义结构体”。嵌套 JSON 解析失败，90% 是因为 Go 结构体字段没对齐 JSON 键名或类型不匹配。

比如有如下 JSON：

{"user":{"name":"Alice","profile":{"age":30,"tags":["dev","gopher"]}}}

对应结构体必须显式声明嵌套层级：

type Response struct {
    User struct {
        Name   string `json:"name"`
        Profile struct {
            Age  int      `json:"age"`
            Tags []string `json:"tags"`
        } `json:"profile"`
    } `json:"user"`
}

注意点：

所有字段必须是导出（首字母大写），否则 json.Unmarshal 会忽略
json: 标签里的键名要和 JSON 字段完全一致（包括大小写、下划线）
嵌套结构体可以匿名，也可以单独定义为命名类型（推荐后者，利于复用和测试）

遇到动态键名或不确定字段时用 `map[string]interface{}`

当 JSON 中某个对象的键名不固定（比如配置项、API 返回的扩展字段），硬编码结构体就不可行。这时得退回到通用解析方式。

例如：

{"data":{"2023-01":{"count":12},"2023-02":{"count":18}}}

年份是动态生成的，无法预设字段名。正确做法是先解到 map[string]interface{}，再逐层转换：

Aria2 Json Rpc

通过 JSON‑RPC 2.0 与 aria2 下载管理器交互，使用自然语言命令管理下载、查询状态并控制任务。适用于 aria2、下载管理或种子操作。

下载

var raw map[string]interface{}
err := json.Unmarshal(data, &raw)
if err != nil { return err }
dataMap := raw["data"].(map[string]interface{})
for dateStr, v := range dataMap {
    item := v.(map[string]interface{})
    count := int(item["count"].(float64)) // JSON 数字默认是 float64
    fmt.Printf("%s → %d\n", dateStr, count)
}

容易踩的坑：

interface{} 类型断言必须小心，v.(map[string]interface{}) 失败会 panic，建议用带 ok 的形式：if m, ok := v.(map[string]interface{}); ok { ... }
JSON 中的数字一律转为 float64，哪怕原始是整数，需要手动转 int 或 int64
深层嵌套后类型断言链变长，可考虑封装辅助函数避免重复判断

用 `json.RawMessage` 延迟解析不确定子结构

有些场景下，顶层结构固定，但某个字段的内容格式可能多种（比如 webhook 事件类型不同，payload 结构各异）。这时候提前全部解成 interface{} 效率低，又不想写一堆 if/else 判断类型。

json.RawMessage 是字节切片的别名，它跳过解析，把原始 JSON 字节存下来，等真正需要时再按具体类型解：

type Webhook struct {
    Event string          `json:"event"`
    Data  json.RawMessage `json:"data"`
}

var wh Webhook
json.Unmarshal(payload, &wh)

switch wh.Event {
case "user.created":
    var u UserCreated
    json.Unmarshal(wh.Data, &u)
case "order.updated":
    var o OrderUpdated
    json.Unmarshal(wh.Data, &o)
}

为什么不用 interface{}？