如何使用Golang捕获JSON解析错误_结合encoding/json处理异常

Go语言JSON解析需精准错误处理：区分json.SyntaxError、json.UnmarshalTypeError等类型定位问题，用UnmarshalJSON方法增强容错，结合struct tag控制行为，统一处理并脱敏日志。

Go 语言中使用 encoding/json 解析 JSON 时，错误处理不能只靠 if err != nil 粗粒度判断，而应结合错误类型、字段上下文和结构体设计，精准定位和响应问题。

区分常见 JSON 解析错误类型

json.Unmarshal 返回的错误通常是 *json.SyntaxError、*json.UnmarshalTypeError 或 *json.InvalidUnmarshalError。直接打印错误可能只显示模糊信息（如“invalid character 'x' after object key”），但类型断言可提取关键细节：

• *json.SyntaxError：指出错位置（Offset），可用于定位原始 JSON 中的非法字符
• *json.UnmarshalTypeError：包含出错字段名（Field）、期望类型（Type）和实际值（Value），对调试字段类型不匹配极有用
• io.EOF 或 io.ErrUnexpectedEOF：常出现在 JSON 截断或空输入时，需单独检查

用自定义 UnmarshalJSON 方法增强容错

对易出错字段（如数字/字符串混用、可选字段缺失），可在结构体中实现 UnmarshalJSON 方法，把解析逻辑收口并提供降级策略：

• 将字符串数字（如 "123"）自动转为 int，避免 UnmarshalTypeError
• 对缺失字段返回默认值，而非报错（如空字符串、零值）
• 捕获子错误后包装为带上下文的新错误（例如加上 "parsing user.age"）

结合结构体标签控制解析行为

合理使用 struct tag 可减少错误发生概率：

• json:",omitempty"：跳过零值字段，避免反序列化时因空值触发校验失败
• json:"name,string"：告诉解码器把 JSON 字符串当作目标字段类型（如把 "123" 当作 int 解析）
• json:"-"：忽略该字段，防止未知字段导致解析中断（配合 Decoder.DisallowUnknownFields() 可精细控制）

统一错误处理与日志记录建议

在服务端 API 中，不建议把原始 JSON 错误直接返回给前端。推荐做法：

• 对客户端错误（如格式错误、字段类型错）返回 400 Bad Request + 清晰提示（如 “age must be a number”）
• 记录完整原始 JSON 和错误详情到日志（注意脱敏敏感字段）
• 使用中间件或封装函数统一处理 json.Unmarshal 调用，避免每个 handler 重复写错误分支