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 当第一等公民对待，而不是补丁式地事后处理。