json.Unmarshal 仅在 JSON 语法错误、类型不匹配或结构体字段不可导出等硬性约束违反时返回错误；字段名不匹配、多余字段或空值默认忽略，不会报错。
go 中 `json.unmarshal` 仅在 json 语法错误、类型不匹配或结构体字段不可导出等硬性约束违反时返回错误；字段名不匹配、多余字段或空值默认忽略，不会报错。
在 Go 的标准库 encoding/json 中，json.Unmarshal 的设计遵循“宽容解析”（lenient parsing）原则：它只校验必要约束，对非关键差异静默忽略。这意味着开发者常误以为“字段缺失或多余 = 解析失败”，实则不然——真正触发错误的场景有限且明确。
✅ 会返回 error 的典型情况
1. JSON 语法错误（Syntax Error）
非法 JSON 字符串（如缺少引号、括号不匹配、非法标识符）将立即导致解析中断：
type A struct {
Name string `json:"name"`
}
data := []byte(`{"name":what?}`) // ❌ "what?" 未加引号，不是合法 JSON 字符串
var a A
err := json.Unmarshal(data, &a)
fmt.Println(err) // 输出：invalid character 'w' looking for beginning of value2. 类型无法转换（Type Mismatch）
JSON 值类型与目标字段类型不兼容，且 Go 无法自动转换（如 bool → string、number → string、null 赋给非指针非接口非切片字段）：
type B struct {
Name string `json:"name"`
}
data := []byte(`{"name":false}`) // ❌ JSON boolean 无法存入 Go string
var b B
err := json.Unmarshal(data, &b)
fmt.Println(err) // 输出：cannot unmarshal bool into Go value of type string其他常见类型冲突示例：
- {"age":"25"} → Age int：字符串数字不能自动转为整型（需显式处理或使用 json.Number）
- {"active":null} → Active bool：null 无法赋值给非指针布尔字段（可改为 *bool 或 sql.NullBool）
3. 结构体字段不可导出（Unexported Field）
若目标字段名小写（即未导出），即使有 json tag，Unmarshal 也无法写入，且不报错但不赋值；严格来说这不算 error，但属常见陷阱：
type C struct {
name string `json:"name"` // ❌ 小写 name 不可导出 → 解析后始终为空字符串
}
data := []byte(`{"name":"Alice"}`)
var c C
err := json.Unmarshal(data, &c)
fmt.Println(c.name, err) // 输出："" <nil> —— 无错误，但值未更新！✅ 正确写法：首字母大写 Name string。
4. 目标为 nil 指针或不支持类型
var p *struct{ X int } = nil
json.Unmarshal([]byte(`{"X":1}`), p) // panic: Unmarshal(nil)或传入非指针、非切片、非映射等不可寻址类型（如 json.Unmarshal(data, a) 缺少 &）也会 panic，但这是调用错误，非 Unmarshal 自身返回 error。
⚠️ 不会返回 error 的常见“看似异常”情况（重点注意）
| 场景 | 示例 | 行为 |
|---|---|---|
| JSON 多余字段 | {"status":false} → struct{ Name string } | 完全忽略 status，不报错 |
| 字段名不匹配（tag 错误/缺失） | json:"nam" 但 JSON 含 "name" | 字段保持零值，不报错 |
| JSON 字段缺失 | {"age":30} → struct{ Name, Age int } | Name 为 ""（string 零值），不报错 |
| null 值赋给指针字段 | {"name":null} → Name *string | Name 被设为 nil，不报错 |
? 提示：如需检测多余字段，可实现 json.Unmarshaler 接口，或使用 json.RawMessage + 手动校验；启用严格模式可借助第三方库（如 jsonschema）。
✅ 最佳实践建议
- 始终检查 err != nil：虽然不频繁，但一旦发生必为严重问题；
- 确保结构体字段导出（首字母大写）并正确设置 json tag；
- 对可选字段使用指针或 omitempty（如 Name *string 或 Name stringjson:",omitempty"`）；
- 避免依赖隐式类型转换：JSON number → Go string、bool → int 等均不支持，应预处理或改用 json.Number；
- 测试边界用例：手动构造 null、类型错位、语法错误 JSON 验证健壮性。
理解 json.Unmarshal 的错误边界，是写出稳定、可维护 JSON 处理逻辑的关键一步——它不替你做假设，只忠实地执行类型契约。
