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"` }
• 建议加上 json tag 明确映射，尤其当 JSON 键名含下划线或大小写不一致时

JSON 类型与 Go 类型不兼容

比如 JSON 字符串想解析进 int 字段，或 null 值赋给非指针/非空接口字段，都会直接返回 error。

jm-jsjkxyjs02-zlm-405

使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。

下载

• 常见报错：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% 的问题都能快速定位。