GolangJSON解析测试技巧全解析

本文深入解析了Go语言中JSON序列化与反序列化的测试要点，强调必须确保结构体字段导出并合理使用JSON标签以实现准确映射，同时系统覆盖边界场景（如null、空字符串、缺失字段、非法输入）、自定义UnmarshalJSON的潜在陷阱（循环引用、副作用、panic风险）、nil指针与空对象的零值行为验证，以及Marshal输出的标准化比对技巧（借助json.Compact或Indent避免格式干扰），并通过子测试驱动方式清晰隔离各类错误类型，帮助开发者构建健壮、可维护且符合业务预期的JSON处理逻辑。

测试 json.Unmarshal 是否正确处理结构体字段

Go 的 encoding/json 默认按字段名（首字母大写）映射 JSON 键，小写字段会被忽略。测试时必须确认结构体字段有正确的 JSON 标签或导出状态。

• 确保结构体字段是导出的（首字母大写），否则 json.Unmarshal 不会赋值
• 用 json:"key" 标签显式指定映射关系，避免依赖默认行为
• 测试空字符串、null、缺失字段等边界情况，例如："name": null 对应指针字段才安全

type User struct {
    Name  string  `json:"name"`
    Age   int     `json:"age"`
    Email *string `json:"email,omitempty"`
}
data := []byte(`{"name": "Alice", "age": 30}`)
var u User
err := json.Unmarshal(data, &u)
// err 为 nil 且 u.Name == "Alice" 才算通过

验证 json.Marshal 输出是否符合预期格式

输出 JSON 时容易忽略缩进、空字段处理、时间格式等问题。直接比较原始字节或使用 json.Compact 消除空格再比对更可靠。

• 避免用 == 直接比对原始 JSON 字符串，换行/空格差异会导致失败
• 用 json.Marshal 后再 json.Compact 标准化，或用 json.MarshalIndent 固定格式做快照测试
• 注意 time.Time 默认序列化为 RFC3339 字符串，若业务要求 Unix 时间戳，需自定义 MarshalJSON

u := User{Name: "Bob", Age: 25}
b, _ := json.Marshal(u)
var compact bytes.Buffer
json.Compact(&compact, b)
expected := `{"name":"Bob","age":25}`
if compact.String() != expected {
    t.Error("marshal output mismatch")
}

用子测试（subtest）覆盖多种 JSON 输入错误场景

常见解析失败包括：语法错误、类型不匹配、嵌套过深、超大数字溢出。每个错误类型应单独子测试，便于定位问题来源。

• invalid character 类型错误通常来自非法 JSON 字符（如单引号、尾逗号）
• json: cannot unmarshal number into Go struct field 表示字段类型与 JSON 值不兼容（比如 JSON 字符串往 int 字段塞）
• 用 t.Run 给每个 case 命名，失败时能一眼看出是哪个输入触发了问题

func TestUserUnmarshalErrors(t *testing.T) {
    tests := []struct{
        name, input string
        wantErr     bool
    }{
        {"missing quote", `{"name": "Alice`, true},
        {"wrong type", `{"age": "thirty"}`, true},
        {"valid", `{"name":"Alice","age":30}`, false},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            var u User
            err := json.Unmarshal([]byte(tt.input), &u)
            if (err != nil) != tt.wantErr {
                t.Errorf("unexpected error status: %v", err)
            }
        })
    }
}

测试自定义 UnmarshalJSON 方法时注意循环引用和副作用

当结构体实现 UnmarshalJSON 时，常需手动解析再调用 json.Unmarshal，但容易误用 *p = ... 导致 panic，或在方法内修改外部状态干扰其他测试。

• 不要在自定义方法里直接对 *p 赋值结构体字面量，应先清空再填充（尤其含 slice/map 字段）
• 避免在 UnmarshalJSON 中调用可能失败的外部函数（如 HTTP 请求），这会让单元测试不可控
• 测试时传入非法 JSON，确认自定义逻辑能返回明确错误，而不是静默失败

func (u *User) UnmarshalJSON(data []byte) error {
    type Alias User // 防止递归调用
    aux := &struct {
        CreatedAt string `json:"created_at"`
        *Alias
    }{
        Alias: (*Alias)(u),
    }
    if err := json.Unmarshal(data, &aux); err != nil {
        return err
    }
    if aux.CreatedAt != "" {
        t, _ := time.Parse("2006-01-02", aux.CreatedAt)
        u.CreatedAt = t
    }
    return nil
}

实际写测试时，最容易被忽略的是对 nil 指针字段和空 JSON 对象（{}）的处理 —— 它们不会触发任何字段赋值，但业务逻辑可能依赖默认零值，这时候需要显式检查字段是否仍为零值而非假设已初始化。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GolangJSON解析测试技巧全解析》文章吧，也可关注golang学习网公众号了解相关技术文章。