GolangJSON序列化反序列化测试技巧

Go语言中JSON序列化与反序列化的测试极易因字段可见性、结构体标签（如`omitempty`）、零值处理、时间格式、指针/接口类型等细节而失效，仅比对原始字节或简单断言远不足以保障语义一致性；真正可靠的测试必须通过泛型round-trip函数完整走通“struct → JSON字节 → struct”全链路，并借助`cmp.Equal`进行深度、类型安全的值比较，同时针对`time.Time`、`json.Number`、`interface{}`、HTTP请求响应等高频陷阱场景设计专项验证逻辑，确保业务关键的数据保真度与行为可逆性。

为什么 json.Marshal 和 json.Unmarshal 测试容易出错

因为 Go 的 encoding/json 对字段可见性、结构体标签、零值处理非常敏感，测试时若只比对原始字节或简单打印，会漏掉关键行为：比如私有字段被忽略、空字符串与 nil 切片序列化结果相同、time.Time 默认转成 RFC3339 字符串但反序列化需显式配置等。

真正可靠的测试必须覆盖：struct → []byte → struct 全链路，并验证字段值、类型、边界情况是否一致。

• 结构体字段必须是导出的（首字母大写），否则 json.Marshal 会跳过
• json:",omitempty" 标签在零值字段上会完全省略该 key，反序列化时对应字段保持零值——不是 nil，而是默认值
• 嵌套结构体中含指针字段时，nil 指针会被序列化为 null，但反序列化后仍是 nil，需手动检查是否为 nil

如何写一个可复用的 JSON round-trip 测试函数

避免每个结构体都手写 Marshal + Unmarshal + 字段断言。封装一个泛型函数，自动完成序列化→反序列化→深度比较。

注意：Go 1.18+ 支持泛型，使用 cmp.Equal（来自 github.com/google/go-cmp/cmp）比 reflect.DeepEqual 更安全，能识别函数、map 无序性等差异。

func TestJSONRoundTrip(t *testing.T) {
	type Person struct {
		Name  string  `json:"name"`
		Age   int     `json:"age"`
		Tags  []string `json:"tags,omitempty"`
		Email *string `json:"email,omitempty"`
	}

	original := Person{
		Name: "Alice",
		Age:  30,
		Tags: []string{"dev", "golang"},
	}

	data, err := json.Marshal(original)
	if err != nil {
		t.Fatal(err)
	}

	var decoded Person
	if err := json.Unmarshal(data, &decoded); err != nil {
		t.Fatal(err)
	}

	if !cmp.Equal(original, decoded) {
		t.Errorf("round-trip mismatch:\noriginal: %+v\ndecoded: %+v", original, decoded)
	}
}

测试常见陷阱：时间、数字、空接口

time.Time、float64、interface{} 是 JSON 测试高频翻车点：

• time.Time 序列化后是字符串，反序列化需用 json.UnmarshalText 或自定义 UnmarshalJSON 方法；直接反序列化到 time.Time 字段是可行的，但必须确保输入格式匹配（默认 RFC3339）
• json.Number 可用于延迟解析数字，避免浮点精度丢失；测试时若期望整数，应显式用 int64(n.Int64()) 而非 int(n)（可能 panic）
• interface{} 接收任意 JSON 值，但反序列化后是 map[string]interface{}、[]interface{}、float64 等具体类型，不能直接和原始结构体比较

示例：测试含 time.Time 的结构体时，务必用 time.Parse 验证字符串格式是否符合预期，而不是只检查是否非零。

如何模拟 HTTP 请求/响应中的 JSON 测试

真实场景中，JSON 往往出现在 http.Request.Body 或 http.ResponseWriter 中。测试时别直接传 bytes.Reader，而应构造完整请求上下文：

• 用 httptest.NewRequest("POST", "/api", bytes.NewReader(data)) 模拟带 JSON body 的请求
• 用 httptest.NewRecorder() 捕获响应，再用 json.Unmarshal(recorder.Body.Bytes(), &v) 验证输出
• 注意设置 req.Header.Set("Content-Type", "application/json")，否则某些 handler 可能跳过解析

如果 handler 内部调用了 json.NewDecoder(req.Body).Decode(&v)，测试时必须确保 req.Body 可重读（bytes.NewReader 支持，但 os.Stdin 不支持）。

测试 JSON 的复杂点不在语法，而在语义一致性：字段是否存在、零值是否被丢弃、时间格式是否可逆、嵌套结构是否保真。最容易被忽略的是 omitempty 在空切片和 nil 切片上的行为完全一致，但业务逻辑中二者含义可能不同。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《GolangJSON序列化反序列化测试技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。