Go中JSON解析不抛异常而返回error，须用if err != nil检查；可类型断言json.SyntaxError或json.UnmarshalTypeError定位问题；推荐预校验json.Valid()、用omitempty标签和json.RawMessage提升容错。
在 Go 中解析 JSON 时，encoding/json 包不会抛出传统意义上的“异常”，而是通过返回 error 值来表示失败。正确处理这些错误是保障程序健壮性的关键。
理解 JSON 解析的典型错误类型
常见错误包括：结构体字段标签不匹配、JSON 数据格式非法（如缺少引号、逗号错误）、类型不兼容（如把字符串当数字解析）、嵌套结构缺失或类型错位等。这些都会导致 json.Unmarshal 返回非 nil 的 error。
基础错误检查：始终检查 error 返回值
不要忽略 err 参数——这是最常见也最危险的疏忽。
- 使用标准的 if err != nil 检查，立刻处理或记录
- 避免写成
json.Unmarshal(data, &v); if err != nil { ... }（err 未声明或作用域错误） - 推荐写法：
if err := json.Unmarshal(data, &v); err != nil { log.Printf("JSON 解析失败: %v", err) }
区分错误语义：用 errors.Is 或字符串判断定位问题
Go 标准库的 json 错误没有导出具体类型，但你可以借助错误文本或封装辅助函数增强可读性：
立即学习“go语言免费学习笔记（深入）”；
-
strings.Contains(err.Error(), "invalid character")→ 通常是非法 JSON 字符（如中文逗号、BOM 头、控制字符） -
strings.Contains(err.Error(), "cannot unmarshal")→ 类型不匹配（如期望 float64 却给了 string） - 更稳妥方式：用
json.SyntaxError或json.UnmarshalTypeError类型断言获取结构化信息
例如：
if syntaxErr, ok := err.(*json.SyntaxError); ok {
log.Printf("JSON 语法错误，位置 %d: %v", syntaxErr.Offset, syntaxErr.Error())
}
if typeErr, ok := err.(*json.UnmarshalTypeError); ok {
log.Printf("类型错误：期望 %s，但得到 %s（字段 %s）",
typeErr.Type, typeErr.Value, typeErr.Field)
}
提升容错能力：预校验 + 默认值 + 自定义 UnmarshalJSON
对不可控输入（如 API 请求），可组合多种策略降低崩溃风险：
- 先用
json.Valid()快速判断是否为合法 JSON 字节流（不解析，仅语法检查） - 结构体字段使用指针或
omitempty标签，允许缺失字段 - 为关键字段提供默认值逻辑（在
UnmarshalJSON方法中实现自定义反序列化） - 对不确定字段使用
json.RawMessage延迟解析，避免早期失败
不复杂但容易忽略。核心就一条：把 error 当第一等公民对待，而不是补丁式地事后处理。
