Go 的 json.Unmarshal 依赖反射,仅处理导出字段(首字母大写),非导出字段无论有无 json 标签均被忽略;常见错误是字段未导出或标签拼写错误导致解析后仍为零值。
Go 的 json.Unmarshal 本质就是靠反射工作的
它不依赖结构体标签以外的任何元信息,但必须能通过反射访问字段——也就是说,只有导出(首字母大写)字段才会被解析。非导出字段无论有没有 json:"xxx" 标签,一律忽略。
常见错误现象:json.Unmarshal 成功返回 nil 错误,但结构体字段仍是零值。大概率是字段未导出,或标签拼写错误(比如写成 json"xxx" 少了冒号)。
- 结构体字段必须以大写字母开头
-
json:标签中的字段名要和 JSON key 完全匹配(区分大小写),除非用json:",string"强制转字符串解析 - 嵌套结构体字段同样需导出;匿名字段若导出且无冲突,会自动展开
手动用 reflect.Value.SetMapIndex 填充 map[string]interface{} 到结构体?别这么干
有人想绕过 json.Unmarshal,自己用反射逐字段赋值,典型场景是想在反序列化时做字段级预处理(如 trim 空格、转换时间格式)。但直接操作 reflect.Value 填充结构体极易 panic:比如对不可寻址的 value 调用 Set,或类型不匹配时调用 SetString。
更稳妥的做法是先用 json.Unmarshal 解到 map[string]interface{} 或 json.RawMessage,再按需处理对应字段,最后用标准方式重新解到目标结构体——或者干脆自定义 UnmarshalJSON 方法。