Go语言JSON序列化错误需定位具体字段、类型不匹配或空值问题并记录可读上下文；常见失败场景包括字段未导出、类型不支持、标签不匹配、数值越界、nil指针解引用；应封装SafeMarshal统一记录上下文与脱敏数据，反序列化启用DisallowUnknownFields并为关键字段实现自定义UnmarshalJSON校验，日志中显式输出字段路径与原始值。
Go语言中处理JSON序列化错误，关键不是只捕获json.Marshal或json.Unmarshal的错误，而是要定位到具体字段、类型不匹配或空值问题，并记录可读的上下文信息，便于排查数据源头缺陷。
明确常见JSON序列化失败场景
Go的json包在以下情况会返回错误：
- 结构体字段未导出（首字母小写），导致无法被序列化/反序列化
- 字段类型不支持JSON（如函数、channel、未实现
json.Marshaler的自定义类型） - 反序列化时JSON字段名与结构体标签（
json:"xxx"）不匹配，且无对应字段又未设json:",omitempty" - 数值越界（如
int64字段传入超大JSON数字） - 嵌套结构中某一层出现
nil指针且未加omitempty，而该字段类型不可为空（如time.Time）
用包装函数统一记录错误上下文
直接调用json.Marshal只能得到泛泛的错误信息（如“json: unsupported type: func()”），建议封装一层，传入原始数据标识（如ID、来源模块），并在日志中打印数据快照（注意脱敏）：
func SafeMarshal(v interface{}, context string) ([]byte, error) {
data, err := json.Marshal(v)
if err != nil {
// 记录带上下文的错误，避免只记“marshal failed”
log.Printf("[JSON Marshal Error] Context: %s, Value: %+v, Err: %v",
context,
redactSensitive(v), // 自定义脱敏函数，避免打印密码/token
err)
return nil, fmt.Errorf("json marshal failed in %s: %w", context, err)
}
return data, nil
}
反序列化时启用严格模式并校验字段
默认json.Unmarshal会忽略未知字段。若需及时发现字段错配，可用json.Decoder.DisallowUnknownFields()：
立即学习“go语言免费学习笔记（深入）”；
decoder := json.NewDecoder(r)
decoder.DisallowUnknownFields() // 遇到JSON中存在结构体没有的字段时立即报错
var user User
if err := decoder.Decode(&user); err != nil {
log.Printf("Decode failed for user data: %v, raw input: %s",
err, string(dumpRawInput(r))) // 可临时读取并截断原始字节流
return err
}
同时，在结构体中为关键字段添加自定义UnmarshalJSON方法，对空字符串、非法格式等主动报错并附带字段名：
func (u *User) UnmarshalJSON(data []byte) error {
type Alias User // 防止无限递归
aux := &struct {
Name *string `json:"name"`
Age *int `json:"age"`
*Alias
}{
Alias: (*Alias)(u),
}
if err := json.Unmarshal(data, &aux); err != nil {
return err
}
if aux.Name != nil && *aux.Name == "" {
return errors.New("field 'name' cannot be empty")
}
if aux.Age != nil && (*aux.Age < 0 || *aux.Age > 150) {
return errors.New("field 'age' out of valid range [0,150]")
}
return nil
}
日志中保留结构体字段路径和原始值
当错误涉及嵌套结构（如User.Profile.Address.ZipCode），单纯打印%+v不易定位。可借助第三方库（如go-jsonerror）或手写反射辅助函数提取出错字段路径。更轻量的做法是：在关键业务入口做预检——对输入结构体做空值/范围检查，并在错误日志中显式写出字段名和当前值：
func ValidateUserInput(u User) error {
if u.Name == "" {
return fmt.Errorf("validation failed: User.Name is empty")
}
if u.Age < 0 {
return fmt.Errorf("validation failed: User.Age = %d < 0", u.Age)
}
if u.Profile == nil {
return fmt.Errorf("validation failed: User.Profile is nil")
}
if u.Profile.Address == nil {
return fmt.Errorf("validation failed: User.Profile.Address is nil")
}
return nil
}
这类检查放在JSON序列化前，能提前暴露问题，避免错误淹没在底层JSON错误堆栈中。
