GolangJSON反序列化教程详解

Golang 的 JSON 反序列化看似简单，实则暗藏诸多易被忽视的“坑”：必须传结构体指针否则解析结果全为零值；导出字段若未正确添加 `json:"key"` 标签，将无法与小写下划线等常见 JSON 键名匹配；类型不兼容（如数字赋给字符串、null 赋给非指针字段）会直接报错，而忽略错误检查则导致静默失败；重复解析同一数据浪费性能，大 JSON 缺乏流式支持需全量加载；更关键的是，tag 遗漏、err 忽略、指针误用等低级失误往往在上线后才暴露，排查困难。掌握这些核心细节，才能让 JSON 解析既健壮又高效。

json.Unmarshal 传入的必须是指针

传 json.Unmarshal 一个普通变量（比如 var u User），它不会报错，但解析结果永远是零值。因为 Go 是值传递，函数内部只能修改副本。

正确做法永远是传地址：&u。哪怕结构体字段全是导出的、类型完全匹配，不传指针就白解析。

• 错误写法：json.Unmarshal(data, u) → 字段全为零值
• 正确写法：json.Unmarshal(data, &u)
• 如果解析到 map 或 slice，也要传指针：json.Unmarshal(data, &m) 或 json.Unmarshal(data, &s)

struct 字段没加 json tag 就无法反序列化

Go 的 json 包默认只处理导出字段（首字母大写），且要求字段名与 JSON key 完全一致（大小写敏感）。实际 JSON 常用小写下划线命名（如 user_name），不加 tag 就对不上。

别指望“自动转驼峰”——标准库不干这事，第三方库才可能支持。

• JSON 中是 "user_id"，结构体字段得写 UserID int `json:"user_id"`
• 字段想忽略就用 json:"-"；想允许空字符串或 null 赋值给 string，用 json:",omitempty"（注意：它只影响序列化，不影响反序列化）
• 嵌套结构体字段也要逐层加 tag，漏一层就解析失败

反序列化时类型不匹配导致静默失败或 panic

json.Unmarshal 对类型不匹配的容忍度很低：数字进 string、bool 进 int、null 进非指针字段，都会直接返回 json.UnmarshalTypeError 错误。但很多人忽略 err 检查，结果变量还是零值，还以为数据丢了。

• 常见错误现象：json: cannot unmarshal number into Go struct field X of type string
• string 类型字段收到 null？必须改成 *string 才能接住（否则报错）
• 整数字段收到浮点数（如 123.0）？Go 默认允许，但精度可能丢失；想严格校验就得先用 json.RawMessage 手动解析
• 切片字段收到非数组值（比如 null 或对象）？会报错，不是变成空切片

性能和兼容性：不要反复 Unmarshal 同一段 data

每次调用 json.Unmarshal 都要重新解析整个字节流，开销不小。如果同一段 []byte 要解析成多个结构体（比如先看 type 字段再分发），别重复调用。

更稳妥的做法是先解析成 map[string]interface{} 或 json.RawMessage，再按需转换。虽然内存多占一点，但避免了重复词法分析。

• 高频场景（如 API 网关）建议用 json.RawMessage 延迟解析关键子字段
• 注意：json.RawMessage 保存的是原始字节引用，如果原始 []byte 被复用或释放，它会失效
• 标准库不支持流式解析（不像 Python 的 ijson），大 JSON 必须全加载进内存

最常被跳过的其实是错误检查和字段 tag 的一致性——写完 struct 不顺手补上 tag，或者把 err 写成 _，后面排查时就得一行行打日志。JSON 反序列化看着简单，崩起来悄无声息。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。