Go中JSON解析错误主因是类型不匹配、字段缺失或结构体定义不当；需确保字段导出、类型一致、合理处理null及嵌套结构，并善用json tag与调试技巧。
Go 中解析 JSON 出错，通常不是语法问题，而是类型不匹配、字段缺失或结构体定义不当导致的。关键要理解 json.Unmarshal 的行为和常见错误来源。
结构体字段必须导出（首字母大写）
Go 的 encoding/json 只能访问导出字段。如果结构体字段是小写开头，反序列化时会被忽略，也不报错，但值始终为零值。
- ❌ 错误示例：
type User struct { name string }→name不会被填充 - ✅ 正确写法：
type User struct { Name string `json:"name"` } - 建议加上
jsontag 明确映射，尤其当 JSON 键名含下划线或大小写不一致时
JSON 类型与 Go 类型不兼容
比如 JSON 字符串想解析进 int 字段，或 null 值赋给非指针/非空接口字段，都会直接返回 error。
- 常见报错：
json: cannot unmarshal string into Go struct field X of type int -
解决方法：用对应类型（如
string接收再转），或用json.Number做中间解析 - 遇到可能为
null的字段，优先用指针（*int）或sql.NullInt64类型，或自定义 UnmarshalJSON 方法
嵌套结构或数组解析失败
JSON 是对象但代码期望是数组，或嵌套层级与结构体不一致，也会 panic 或返回 error。
- 检查原始 JSON 是否有多余的外层包装（比如
{"data": [...]}），别直接往切片上 unmarshal - 不确定结构时，先用
map[string]interface{}或json.RawMessage延迟解析 - 对动态 key 的对象（如
{"2023-01": {...}, "2023-02": {...}}），用map[string]User而非固定结构体
忽略未知字段或容忍缺失字段
默认情况下，JSON 多出字段不会报错，但结构体字段在 JSON 中缺失时，会设为零值——这本身不报错，但可能引发后续逻辑错误。
- 想检测字段缺失？加
json:",required"tag（Go 1.22+ 支持，旧版本需手动校验） - 想忽略未知字段避免干扰？用
json.Decoder.DisallowUnknownFields() - 调试时打印原始字节或用
json.Compact格式化输出，快速比对结构差异
基本上就这些。JSON 解析错误不复杂但容易忽略细节，重点盯住结构体定义、字段可见性、类型一致性这三点，90% 的问题都能快速定位。
