Golang JSON序列化反序列化测试方法

在Go语言中，可靠地测试JSON序列化与反序列化需紧扣“往返一致性”这一核心目标——即原始结构体经json.Marshal再json.Unmarshal后，字段值、类型语义和零值行为必须严格一致；文章系统梳理了涵盖指针、切片、time.Time、omitempty逻辑、嵌套结构及错误场景的完整测试策略，强调通过精细化子测试覆盖各类边界状态（如nil指针、空切片、UTC时间精度、循环引用等），并提醒避开reflect.DeepEqual的陷阱、正确处理自定义编解码逻辑与浮点精度问题，为构建健壮、可维护的JSON交互提供了一套即开即用的工程化测试范式。

在 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 处理

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。