Golang JSON序列化错误处理方法

答案：Go中处理JSON错误需检查json.Marshal和json.Unmarshal返回的error，常见问题包括字段未导出、含不支持类型、JSON格式错误等。应使用DTO结构体、omitempty标签及类型断言区分SyntaxError、UnmarshalTypeError，并通过统一错误拦截提升健壮性。

在Go语言中处理JSON序列化错误，关键在于正确使用encoding/json包并检查返回的错误。序列化（结构体转JSON）和反序列化（JSON转结构体）都可能出错，必须显式处理这些错误，避免程序崩溃或数据异常。

理解JSON序列化与反序列化的常见错误

Go中主要通过json.Marshal和json.Unmarshal进行序列化和反序列化。常见错误包括：

• 结构体字段未导出（首字母小写），无法被序列化
• 包含不支持的类型，如chan、func、不可比较的值
• 反序列化时JSON格式不匹配目标结构体
• JSON数据本身格式错误（如非法字符、不闭合的引号）

这些情况都会返回非nil的error，需要判断并处理。

正确处理Marshal（序列化）错误

使用json.Marshal时，即使结构体中有不可序列化的字段，也会直接报错。应始终检查返回的错误。

type User struct {
    Name string
    Age  int
    Conn chan int // 不可序列化的字段
}

user := User{Name: "Alice", Age: 25, Conn: make(chan int)}
data, err := json.Marshal(user)
if err != nil {
    log.Printf("序列化失败: %v", err)
    // 处理错误，如返回默认值或中断流程
}

建议：避免在要序列化的结构体中包含不支持的类型。若必须存在，可通过json:"-"忽略该字段。

妥善处理Unmarshal（反序列化）错误

反序列化时，输入的JSON可能来自外部，更易出错。需验证输入并处理各种异常。

• JSON语法错误：使用json.SyntaxError判断具体问题
• 类型不匹配：如期望数字却收到字符串，会返回json.UnmarshalTypeError
• 字段不存在或多余：不影响解析，但可用Decoder.DisallowUnknownFields()严格控制

var user User
err := json.Unmarshal([]byte(invalidJSON), &user)
if err != nil {
    if syntaxErr, ok := err.(*json.SyntaxError); ok {
        log.Printf("JSON语法错误，位置: %d", syntaxErr.Offset)
    } else if typeErr, ok := err.(*json.UnmarshalTypeError); ok {
        log.Printf("类型错误: 期望%s，实际是%s，字段:%s", typeErr.Type, typeErr.Value, typeErr.Field)
    } else {
        log.Printf("未知反序列化错误: %v", err)
    }
    return
}

提升健壮性的实用建议

为增强程序稳定性，可以采取以下措施：

• 定义专门用于JSON传输的DTO结构体，避免暴露内部结构
• 使用omitempty标签处理可选字段，减少空值干扰
• 对关键接口输入使用中间结构体+校验逻辑，先解析再映射
• 在API层统一拦截和返回JSON解析错误，提升用户体验

基本上就这些。只要每次调用Marshal或Unmarshal都检查error，并针对具体错误类型做响应，就能有效控制JSON处理中的异常情况。