JSON解码失败时，json.Unmarshal统一返回json.UnmarshalTypeError或json.SyntaxError，最常见的是json.UnmarshalTypeError；字段缺失本身不报错，需手动校验。
JSON解码失败时，json.Unmarshal返回什么错误？
它不区分“格式错”和“字段缺”，统一返回 *json.UnmarshalTypeError 或 json.SyntaxError，但最常见的是 json.UnmarshalTypeError——比如把字符串当数字解，或把 null 赋给非指针 struct 字段。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 别只看
err != nil就 panic，先用errors.As判断具体类型：var syntaxErr *json.SyntaxError if errors.As(err, &syntaxErr) { log.Printf("JSON语法错误，位置：%d", syntaxErr.Offset) } - 字段缺失本身不会报错，除非你用了
json:",required"（Go 标准库不支持该 tag，这是常见误解） - 如果字段类型是
int但 JSON 给了"123"（字符串），会直接报json.UnmarshalTypeError，不是静默转成 int
struct 字段没值，是没传还是解错了？
Go 的 json.Unmarshal 对零值非常“宽容”：字段不存在、值为 null、类型不匹配导致跳过，结果都是字段保持零值。你无法单靠字段是否为零判断“用户没传”还是“解析失败”。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用指针字段捕获“未提供”语义：
Name *string，这样nil表示没传，空字符串""才表示传了空值 - 配合
json.RawMessage延迟解析不确定结构的字段，避免一上来就因某个嵌套字段错导致整块失败 - 别依赖
omitempty判断输入完整性——它只影响序列化，不影响反序列化逻辑
怎么让缺失字段触发校验失败？
标准 encoding/json 不提供 required 字段检查。所谓“必填”必须自己实现，否则字段没传就安静地变成零值，线上可能跑着跑着才暴露逻辑 bug。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在
UnmarshalJSON方法里手动检查关键字段是否为零：func (u *User) UnmarshalJSON(data []byte) error { type Alias User // 防止无限递归 aux := &struct { Name *string `json:"name"` Age *int `json:"age"` *Alias }{ Alias: (*Alias)(u), } if err := json.Unmarshal(data, aux); err != nil { return err } if aux.Name == nil { return fmt.Errorf("missing required field: name") } if aux.Age == nil || *aux.Age <= 0 { return fmt.Errorf("invalid or missing age") } return nil } - 用第三方库如
go-playground/validator，但注意它校验的是解码后的 struct，不能替代类型安全的解码过程 - 别在 HTTP handler 里写一堆
if u.Name == ""—— 把校验逻辑收进 struct 自身的UnmarshalJSON或独立的Validate()方法里，更易测、更集中
为什么 json.Number 能帮你少踩坑？
默认情况下，json.Unmarshal 把数字全转成 float64，哪怕 JSON 里写的是 123。这会导致精度丢失（比如大整数 ID）、类型混淆（int vs float）、以及后续 JSON 再序列化时多出小数点。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 启用
UseNumber()：dec := json.NewDecoder(r.Body) dec.UseNumber() // 后续 Unmarshal 会把数字存成 string 形式的 json.Number var data map[string]interface{} if err := dec.Decode(&data); err != nil { ... } - 拿到
json.Number后，再按需转：n.Int64()、n.Float64()、n.String()，失败时能明确知道是溢出还是格式错 - 注意：开启后所有数字字段都变
json.Number，如果你的 struct 字段是int，仍会尝试自动转换，该报错还是报错；真正受益的是map[string]interface{}或interface{}场景
