必须检查json.Unmarshal和json.Marshal的错误并用类型断言区分SyntaxError、UnmarshalTypeError、InvalidUnmarshalError；推荐使用指针/omitempty、实现UnmarshalJSON接口、map分步解析提升健壮性。
在Go语言中处理JSON解析，必须始终检查 json.Unmarshal 和 json.Marshal 的返回错误。标准库的 encoding/json 包会返回特定的错误类型，通过类型断言可以精确识别错误原因，从而进行针对性处理，而不是简单地报告“解析失败”。
常见JSON错误类型及判断方法
Go的json包会抛出几种核心错误，可以通过类型断言（type assertion）来区分：
-
SyntaxError: 表示JSON数据本身格式不合法，比如缺少引号、括号不匹配、存在非法字符等。这是最基础的语法层面的错误。
- if syntaxErr, ok := err.(*json.SyntaxError); ok {
- log.Printf("JSON语法错误，位置: %d", syntaxErr.Offset)
- }
-
UnmarshalTypeError: 当JSON中的值与目标Go结构体的字段类型不匹配时触发。例如，期望一个整数但收到了字符串，或者期望一个对象却收到了数组。
- if typeErr, ok := err.(*json.UnmarshalTypeError); ok {
- log.Printf("类型错误：期望%s，实际是%s，字段:%s", typeErr.Type, typeErr.Value, typeErr.Field)
- }
-
InvalidUnmarshalError: 这通常是因为调用
Unmarshal时传入的目标参数不是一个指向有效类型的指针，比如传了零值、非指针或不支持的类型。- if invErr, ok := err.(*json.InvalidUnmarshalError); ok {
- log.Printf("无效的反序列化参数: %v", invErr.Value)
- }
通过这种分类处理，API服务可以根据错误类型返回更友好的提示信息，帮助前端定位问题。
提升解析健壮性的实用技巧
除了捕获错误，还可以通过设计让程序更能容忍不完美的输入数据：
立即学习“go语言免费学习笔记（深入）”；
-
使用指针或
omitempty标签: 对于可能缺失或为空的字段，将其定义为指针类型（如*string,*int）。这样当JSON中该字段为null或不存在时，Go会将其设为nil，而不会报错。结合json:",omitempty"标签，在序列化时能自动忽略零值或空值字段。 -
实现
UnmarshalJSON接口: 对于类型不确定的复杂场景（如一个字段可能是数字也可能是字符串），可以让自定义类型实现json.Unmarshaler接口。在这个方法里编写自定义逻辑，尝试多种类型转换，从而兼容不同的输入格式。 -
利用map分步解析: 如果需要精确定位哪个具体字段导致了解析失败，可以先将JSON解析到一个
map[string]interface{}中。因为这个通用映射几乎能容纳任何JSON结构，所以很少会因类型问题直接失败。之后再手动遍历这个map，对每个键值进行类型断言和转换，这样就能明确知道是哪一个字段的转换出了问题。
基本上就这些。关键是养成检查error的习惯，并善用标准库提供的错误类型和特性。
