如何在Golang中测试JSON序列化和反序列化_验证数据一致性_技术教程

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、空切片、非空值等多种状态。

编写往返测试（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 处理