GolangJSON序列化反序列化测试教程

本文深入探讨了Go语言中JSON序列化与反序列化的可靠测试方法，强调测试的核心目标不是“能否运行”，而是确保双向转换严格保值、保类型、保字段语义——从结构体标签的精准控制（如omitempty、-、嵌套与自定义类型处理），到基于cmp.Equal的双向一致性验证（Round-Trip测试），再到零值、空切片与nil切片、指针嵌套、非法输入等边界场景的全覆盖，以及对自定义MarshalJSON/UnmarshalJSON方法的专项验证，为构建健壮、可维护的API数据交互提供了一套系统化、易落地的测试实践指南。

在 Go 中测试 JSON 序列化（json.Marshal）和反序列化（json.Unmarshal），核心是验证结构体与 JSON 字符串之间的双向转换是否保值、保类型、保字段语义。重点不是“能不能跑通”，而是“数据有没有被意外修改或丢失”。

用结构体标签明确控制 JSON 字段名和行为

Go 的 JSON 编解码依赖结构体字段的标签（如 json:"name"）。测试前先确保标签定义合理：

• 导出字段（首字母大写）才参与序列化；未导出字段默认忽略
• 使用 json:"name,omitempty" 控制零值字段是否输出，测试时需覆盖零值场景（如空字符串、0、nil 切片）
• 用 json:"-" 显式排除敏感或非 JSON 字段，避免误序列化
• 嵌套结构体、指针、时间（time.Time）、自定义类型（如枚举）要单独验证其 JSON 行为

编写双向一致性测试（Marshal → Unmarshal → Equal）

最有效的测试模式是：构造原始结构体 → Marshal 成 JSON → Unmarshal 回新结构体 → 比较原始与还原后的值是否一致。推荐用 cmp.Equal（来自 github.com/google/go-cmp/cmp）代替 reflect.DeepEqual，它能清晰报告差异位置。

示例：

func TestUserJSONRoundTrip(t *testing.T) {
    original := User{
        ID:   123,
        Name: "Alice",
        Tags: []string{"dev", "golang"},
        CreatedAt: time.Date(2024, 1, 15, 10, 30, 0, 0, time.UTC),
    }

    data, err := json.Marshal(original)
    if err != nil {
        t.Fatal(err)
    }

    var restored User
    if err := json.Unmarshal(data, &restored); err != nil {
        t.Fatal(err)
    }

    if !cmp.Equal(original, restored, cmp.Comparer(func(x, y time.Time) bool {
        return x.Equal(y)
    })) {
        t.Errorf("round-trip failed: %s", cmp.Diff(original, restored))
    }
}

覆盖边界和易错场景

仅测“正常值”容易漏掉隐性 bug。以下情况必须单独测试：

• 零值字段：比如 Age int `json:"age,omitempty"`，当 Age == 0 时是否真的被省略？检查生成的 JSON 是否不含 "age": 0
• 空切片 vs nil 切片：两者 JSON 都是 []，但 Go 语义不同；若业务逻辑区分二者，需在 Unmarshal 后手动校验 len(s) == 0 && s == nil
• 嵌套结构体中的指针字段：nil 指针序列化为 null，反序列化后仍是 nil；非 nil 指针需确认深层字段也被正确还原
• 非法 JSON 输入：传入格式错误或字段类型错配的 JSON（如用字符串给数字字段赋值），验证是否返回预期错误，而非静默失败或 panic

对自定义 JSON 行为做单元测试（实现 MarshalJSON/UnmarshalJSON）

当结构体需要特殊序列化逻辑（如把时间转为秒级时间戳、枚举转字符串名），必须为该方法单独写测试：

• 测试 MarshalJSON() 输出是否符合协议约定（如字段名、类型、格式）
• 测试 UnmarshalJSON([]byte) 能否正确解析各种合法输入，且对非法输入返回有意义错误
• 仍要做 round-trip 测试，确保自定义逻辑不破坏一致性

例如，一个将 time.Time 序列化为 Unix 秒的字段：

func (t *Timestamp) MarshalJSON() ([]byte, error) {
    return json.Marshal(t.Time.Unix())
}
func (t *Timestamp) UnmarshalJSON(data []byte) error {
    var sec int64
    if err := json.Unmarshal(data, &sec); err != nil {
        return err
    }
    t.Time = time.Unix(sec, 0)
    return nil
}

对应测试需验证 time.Now().Unix() 和反序列化后的时间是否一致（考虑秒级精度误差）。

理论要掌握，实操不能落！以上关于《GolangJSON序列化反序列化测试教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！