json.Unmarshal反序列化失败时error非nil即出错，但需用errors.As判断具体错误类型（如json.SyntaxError、json.UnmarshalTypeError），不可仅凭err!=nil粗暴处理；字段未导出会导致“假成功”。
直接说结论： json.Unmarshal 反序列化失败时，error 值非 nil 就代表出错了，但错误类型不是统一的，必须用 errors.Is 或类型断言判断具体原因，不能只靠 err != nil 粗暴处理。
常见错误类型及对应现象
Go 的 json 包返回的错误是未导出结构体（如 *json.SyntaxError、*json.UnmarshalTypeError），直接打印可能只看到模糊信息，比如：
-
json: cannot unmarshal string into Go struct field X.Y of type int→ 实际是*json.UnmarshalTypeError -
invalid character 'a' looking for beginning of object→ 实际是*json.SyntaxError -
json: unknown field "foo"（开启DisallowUnknownFields()后）→ 实际是*json.InvalidUnmarshalError或包装后的错误
如何精准识别并处理不同错误
推荐用 errors.As 做类型断言，比字符串匹配更可靠、更安全：
var syntaxErr *json.SyntaxError
var typeErr *json.UnmarshalTypeError
var invalidErr *json.InvalidUnmarshalError
err := json.Unmarshal(data, &v)
if err != nil {
if errors.As(err, &syntaxErr) {
log.Printf("JSON 语法错误，位置：%d", syntaxErr.Offset)
} else if errors.As(err, &typeErr) {
log.Printf("类型不匹配：字段 %q 期望 %v，得到 %v", typeErr.Field, typeErr.Type, typeErr.Value)
} else if errors.As(err, &invalidErr) {
log.Printf("非法反序列化操作：%v", invalidErr)
} else {
log.Printf("其他 JSON 错误：%v", err)
}
return
}
注意：json.UnmarshalTypeError 的 Field 在嵌套结构中可能为空，需结合上下文判断；SyntaxError.Offset 是字节偏移，可用于定位原始 JSON 片段。
立即学习“go语言免费学习笔记（深入）”；
避免静默失败的实用技巧
- 始终检查
err != nil，不要忽略返回值 - 对用户输入或外部 API 返回的 JSON，务必启用
json.NewDecoder(r).DisallowUnknownFields()，防止字段名拼写错误被悄悄丢弃 - 结构体字段加
json:"name,omitempty"标签时，注意omitempty不影响反序列化——它只控制序列化时是否省略零值字段 - 如果要捕获完整原始错误链（比如中间有
io.EOF包裹），用errors.Unwrap或errors.Is(err, io.EOF)判断底层原因
结构体定义不当导致的“假成功”问题
这是最容易被忽略的一类问题：反序列化没报错，但字段值是零值，因为字段不可导出或标签写错。例如：
type User struct {
name string `json:"name"` // 小写首字母 → 不可导出 → 不会被赋值
Age int `json:"age"`
}
结果 name 始终为空字符串，且 json.Unmarshal 不报错。解决方法只有两个：
- 字段首字母大写（
Name string） - 确认所有目标字段都满足 Go 的导出规则（首字母大写 + 非匿名非私有）
另外，json:"-" 标签会完全跳过该字段，也容易误用成“屏蔽字段”，实际是“禁止编解码”。
