如何在Golang中测试JSON序列化和反序列化_保证数据正确性

Go中测试JSON序列化与反序列化需确保双向转换保值、保类型、保字段语义，重点验证标签控制、零值处理、嵌套结构、自定义方法及边界场景。

在 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(2025, 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() 和反序列化后的时间是否一致（考虑秒级精度误差）。

# js # git # json # go # github # golang # ai # unix # google # red # NULL # 字符串 # 结构体 # int # 指针 # 切片 # len # nil # bug # 序列化 # 自定义 # 都是 # 字段名 # 要做 # 仍是 # 不含 # 而非 # 有意义 # 它能

返回目录在线咨询

上一篇：C#实现JSON字符串序列化与反序列化的方法
下一篇：云服务器安装多站点时，资源分配和管理的最佳实践是什么？

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。