Go中测试JSON序列化与反序列化需确保字段值、类型语义、零值行为完全一致,重点覆盖指针、切片、time.Time、omitempty逻辑、往返一致性及错误场景,并用子测试验证各状态。

在 Go 中测试 JSON 序列化(json.Marshal)和反序列化(json.Unmarshal)的关键,是确保原始结构体经编码再解码后,**字段值、类型语义、零值行为完全一致**,尤其注意指针、切片、时间、嵌套结构等易出错场景。
定义可比较的结构体并启用 JSON 标签
结构体需导出字段,并用 json tag 明确控制序列化行为。避免匿名字段或未导出字段干扰测试;对可选字段使用 omitempty 时,要单独验证其省略逻辑是否符合预期。
例如:
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Active *bool `json:"active,omitempty"`
Tags []string `json:"tags,omitempty"`
CreatedAt time.Time `json:"created_at"`
}
注意:*bool 和 []string 在为 nil 时,若带 omitempty,将不出现于 JSON 中——测试中需覆盖 nil、空切片、非空值等多种状态。
立即学习“go语言免费学习笔记(深入)”;
编写往返测试(Round-trip Test)
构造一个实例 → Marshal 成字节 → Unmarshal 回新实例 → 比较原始与还原后的值。推荐使用 reflect.DeepEqual,但要注意它对 time.Time、map 顺序、浮点精度等有局限,必要时手动比对关键字段。
- 用
t.Run为每种数据状态(如 active=nil、active=true、tags=[]、tags=["a"])建子测试 - 对
time.Time字段,建议统一用固定时区(如 UTC)并检查秒级精度是否保留 - 若结构含
map[string]interface{},需确认 key 顺序不影响相等性(JSON 解析后 map 无序,DeepEqual 可接受)
验证 JSON 字符串格式与语义
除了结构相等,还可断言生成的 JSON 字符串是否符合预期格式:
- 用
json.Compact或json.Indent预处理后对比字符串(适合调试) - 用
json.RawMessage捕获中间 JSON,再用json.Unmarshal提取特定字段验证(例如只检查"id"是否为数字) - 对错误场景测试:传入含非法 UTF-8、循环引用、不支持类型的结构,确认
Marshal返回非 nil error
处理常见陷阱
以下情况极易导致往返不一致,测试中应显式覆盖:
-
零值字段 vs nil 指针:
Active: new(bool)(值为 false)和Active: nil在带omitempty时都可能被忽略,但语义不同;测试需区分赋值与未赋值 - 自定义 MarshalJSON/UnmarshalJSON:若实现了这些方法,必须保证它们互为逆操作;建议在测试中单独调用并校验输出
-
嵌套结构中的空值传播:父结构体字段为 nil 结构体指针时,是否应生成
null还是跳过?取决于 tag 和业务逻辑,测试需明确预期 -
浮点数精度:Go 默认序列化 float64 为最多 6 位小数,若需更高精度,需用
json.Encoder.SetEscapeHTML(false)配合自定义 float 处理










