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

17次阅读

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

如何在Golang中测试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,它能清晰报告差异位置。

示例:

立即学习go语言免费学习笔记(深入)”;

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

text=ZqhQzanResources