答案：测试Go结构体与JSON互转需验证序列化输出、反序列化映射、边缘情况处理，并用子测试提升可读性。示例覆盖字段标签、omitempty行为及多场景断言，确保API数据交换的可靠性。
在Golang中测试JSON序列化是确保数据结构正确转换为JSON格式并能被准确还原的关键步骤。特别是在构建API服务或与其他系统交换数据时，结构体与JSON之间的编解码必须可靠。下面介绍几种常见的测试实践，帮助你写出稳定、可维护的JSON序列化测试。
1. 测试结构体到JSON的输出
最常见的需求是验证某个Go结构体是否能正确序列化为预期的JSON字符串。使用 encoding/json 包中的 json.Marshal 并结合 reflect.DeepEqual 或字面量比较即可完成。
示例：
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email,omitempty"`
}
func TestUser_MarshalJSON(t *testing.T) {
user := User{ID: 1, Name: "Alice", Email: "alice@example.com"}
expected := `{"id":1,"name":"Alice","email":"alice@example.com"}`
data, err := json.Marshal(user)
if err != nil {
t.Fatalf("marshal failed: %v", err)
}
if string(data) != expected {
t.Errorf("expected %s, got %s", expected, string(data))
}
}
提示：也可使用 map[string]interface{} 或第三方库如 testify/assert 来做更灵活的断言。
立即学习“go语言免费学习笔记（深入）”；
2. 测试JSON反序列化到结构体
验证JSON字符串能否正确解析回Go结构体，尤其是字段映射、类型匹配和标签处理是否正常。
func TestUser_UnmarshalJSON(t *testing.T) {
input := `{"id": 2, "name": "Bob"}`
var user User
err := json.Unmarshal([]byte(input), &user)
if err != nil {
t.Fatalf("unmarshal failed: %v", err)
}
if user.ID != 2 || user.Name != "Bob" {
t.Errorf("unexpected field values: %+v", user)
}
}
注意：未包含的字段（如Email）会使用零值，这符合Go语言规范，测试中应明确预期。
3. 处理边缘情况和特殊字段
实际开发中常遇到时间、指针、空值、嵌套结构等复杂情况，需专门覆盖测试。
- 测试
omitempty是否生效：当字段为空时不输出到JSON - 测试时间类型（如
time.Time）的格式是否一致 - 测试切片、嵌套结构体的序列化/反序列化
- 测试未知字段是否被忽略（使用
DisallowUnknownFields控制）
示例：验证 omitempty
func TestUser_OmitEmpty(t *testing.T) {
user := User{ID: 1, Name: "Charlie"}
data, _ := json.Marshal(user)
result := string(data)
if strings.Contains(result, "email") {
t.Error("email should be omitted when empty")
}
}
4. 使用子测试提高可读性
将多个场景组织成子测试，让输出更清晰。
func TestUser_JSON(t *testing.T) {
cases := []struct {
name string
user User
expected string
}{
{"with email", User{1, "A", "a@b.com"}, `{"id":1,"name":"A","email":"a@b.com"}`},
{"without email", User{2, "B", ""}, `{"id":2,"name":"B"}`},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
data, _ := json.Marshal(tc.user)
if string(data) != tc.expected {
t.Errorf("expected %s, got %s", tc.expected, string(data))
}
})
}
}
基本上就这些。通过组合基础单元测试和边界用例，你可以有效保障Golang中JSON序列化的正确性。关键是保持测试简洁、覆盖常见场景，并随着结构演变持续更新。不复杂但容易忽略。
