答案是验证结构体字段导出、标签正确性及 round-trip 完整性,通过典型实例序列化反序列化比对,并覆盖零值、错误输入等边界场景确保兼容性。

在 Go 中测试 JSON 序列化(json.Marshal)与反序列化(json.Unmarshal)的关键,是验证结构体定义、字段标签、空值处理、嵌套结构和错误边界是否符合预期。不需要写大量样板代码,重点在于用小而准的测试覆盖常见陷阱。
确保结构体字段可导出且带正确 JSON 标签
Go 的 json 包只能序列化/反序列化首字母大写的导出字段。如果字段名和 JSON 键不一致,必须用 json:"key" 显式声明;忽略字段用 json:"-";省略空值用 json:",omitempty"。
- 测试时,先构造一个典型实例,调用
json.Marshal得到字节切片,再用string()转为字符串断言内容 - 注意:如果字段是私有(小写开头),即使加了 tag 也不会出现在 JSON 中——这是常见疏漏,测试里应显式验证该字段未出现
- 例如:
type User { Name string `json:"name"`; age int `json:"age"` },序列化后不会有"age"字段
用反向流程验证 round-trip 正确性
最实用的测试方式是“序列化 → 反序列化 → 比较原始值”,即 round-trip 测试。它能同时检查 Marshal 和 Unmarshal 行为,尤其对零值、指针、时间、自定义类型等很有效。
- 不要只测 Marshal 后的字符串格式,更要测 Unmarshal 是否还原出等价结构体
- 用
reflect.DeepEqual或更安全的cmp.Equal(来自 golang.org/x/exp/cmp)比对原始值与还原值 - 对含指针或时间字段的结构体,注意
time.Time默认序列化为 RFC3339 字符串,反序列化时需确保布局匹配(如使用time.RFC3339)
显式覆盖零值、nil、omitempty 和错误输入场景
真实接口常收各种松散 JSON,测试不能只靠“正常数据”。要主动构造边界输入,观察行为是否可控。
立即学习“go语言免费学习笔记(深入)”;
- 测试字段为零值(
0、""、nil)时是否被omitempty正确剔除 - 传入非法 JSON 字符串(如缺少引号、多逗号)给
json.Unmarshal,断言返回非 nil error - 对嵌套结构体或 slice,测试空 slice
[]和 nil slice 的序列化差异(默认都转[],但某些 API 有语义区别) - 若结构体含
json.RawMessage,测试它是否原样透传,不触发深层解析
利用 test helper 函数减少重复,保持测试简洁
把通用逻辑(如 marshal + unmarshal + deep equal)抽成私有 helper,让每个测试用例聚焦在“测什么”,而不是“怎么测”。
- 例如写一个
mustMarshal(t *testing.T, v interface{}) []byte,内部 panic on error,适合单元测试快速失败 - 再写
assertRoundTrip(t *testing.T, original, target interface{}),自动完成序列化→反序列化→比较 - 避免在测试里反复写
if err != nil { t.Fatal(err) },用 helper 统一处理
基本上就这些。JSON 测试不复杂但容易忽略字段可见性、零值语义和错误传播路径。用好 round-trip 验证 + 边界 case + 小 helper,就能稳住接口兼容性。










