

新闻资讯
技术学院Go中测试JSON序列化与反序列化需确保双向转换保值、保类型、保字段语义,重点验证标签控制、零值处理、嵌套结构、自定义方法及边界场景。
在 Go 中测试 JSON 序列化(json.Marshal)和反序列化(json.Unmarshal),核心是验证结构体与 JSON 字符串之间的双向转换是否保值、保类型、保字段语义。重点不是“能不能跑通”,而是“数据有没有被意外修改或丢失”。
Go 的 JSON 编解码依赖结构体字段的标签(如 json:"name")。测试前先确保标签定义合理:
json:"name,omitempty" 控制零值字段是否输出,测试时需覆盖零值场景(如空字符串、0、nil 切片)json:"-" 显式排除敏感或非 JSON 字段,避免误序列化time.Time)、自定义类型(如枚举)要单独验证其 JSON 行为最有效的测试模式是:构造原始结构体 → 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
[],但 Go 语义不同;若业务逻辑区分二者,需在 Unmarshal 后手动校验 len(s) == 0 && s == nil
null,反序列化后仍是 nil;非 nil 指针需确认深层字段也被正确还原MarshalJSON/UnmarshalJSON)当结构体需要特殊序列化逻辑(如把时间转为秒级时间戳、枚举转字符串名),必须为该方法单独写测试:
MarshalJSON() 输出是否符合协议约定(如字段名、类型、格式)UnmarshalJSON([]byte) 能否正确解析各种合法输入,且对非法输入返回有意义错误
例如,一个将 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() 和反序列化后的时间是否一致(考虑秒级精度误差)。