Go json.Unmarshal要求字段导出且正确使用JSON标签，需测试边界情况、错误输入、自定义方法及nil/空对象处理，确保映射准确、错误明确、输出可控。
测试 json.Unmarshal 是否正确处理结构体字段
Go 的 encoding/json 默认按字段名（首字母大写）映射 JSON 键，小写字段会被忽略。测试时必须确认结构体字段有正确的 JSON 标签或导出状态。
- 确保结构体字段是导出的（首字母大写），否则
json.Unmarshal不会赋值 - 用
json:"key"标签显式指定映射关系，避免依赖默认行为 - 测试空字符串、
null、缺失字段等边界情况，例如："name": null对应指针字段才安全
type User struct {
Name string `json:"name"`
Age int `json:"age"`
Email *string `json:"email,omitempty"`
}
data := []byte(`{"name": "Alice", "age": 30}`)
var u User
err := json.Unmarshal(data, &u)
// err 为 nil 且 u.Name == "Alice" 才算通过
验证 json.Marshal 输出是否符合预期格式
输出 JSON 时容易忽略缩进、空字段处理、时间格式等问题。直接比较原始字节或使用 json.Compact 消除空格再比对更可靠。
- 避免用
==直接比对原始 JSON 字符串，换行/空格差异会导致失败 - 用
json.Marshal后再json.Compact标准化，或用json.MarshalIndent固定格式做快照测试 - 注意
time.Time默认序列化为 RFC3339 字符串，若业务要求 Unix 时间戳，需自定义MarshalJSON
u := User{Name: "Bob", Age: 25}
b, _ := json.Marshal(u)
var compact bytes.Buffer
json.Compact(&compact, b)
expected := `{"name":"Bob","age":25}`
if compact.String() != expected {
t.Error("marshal output mismatch")
}
用子测试（subtest）覆盖多种 JSON 输入错误场景
常见解析失败包括：语法错误、类型不匹配、嵌套过深、超大数字溢出。每个错误类型应单独子测试，便于定位问题来源。
-
invalid character类型错误通常来自非法 JSON 字符（如单引号、尾逗号） -
json: cannot unmarshal number into Go struct field表示字段类型与 JSON 值不兼容（比如 JSON 字符串往 int 字段塞） - 用
t.Run给每个 case 命名，失败时能一眼看出是哪个输入触发了问题
func TestUserUnmarshalErrors(t *testing.T) {
tests := []struct{
name, input string
wantErr bool
}{
{"missing quote", `{"name": "Alice`, true},
{"wrong type", `{"age": "thirty"}`, true},
{"valid", `{"name":"Alice","age":30}`, false},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
var u User
err := json.Unmarshal([]byte(tt.input), &u)
if (err != nil) != tt.wantErr {
t.Errorf("unexpected error status: %v", err)
}
})
}
}
测试自定义 UnmarshalJSON 方法时注意循环引用和副作用
当结构体实现 UnmarshalJSON 时，常需手动解析再调用 json.Unmarshal，但容易误用 *p = ... 导致 panic，或在方法内修改外部状态干扰其他测试。
立即学习“go语言免费学习笔记（深入）”；
- 不要在自定义方法里直接对
*p赋值结构体字面量，应先清空再填充（尤其含 slice/map 字段） - 避免在
UnmarshalJSON中调用可能失败的外部函数（如 HTTP 请求），这会让单元测试不可控 - 测试时传入非法 JSON，确认自定义逻辑能返回明确错误，而不是静默失败
func (u *User) UnmarshalJSON(data []byte) error {
type Alias User // 防止递归调用
aux := &struct {
CreatedAt string `json:"created_at"`
*Alias
}{
Alias: (*Alias)(u),
}
if err := json.Unmarshal(data, &aux); err != nil {
return err
}
if aux.CreatedAt != "" {
t, _ := time.Parse("2006-01-02", aux.CreatedAt)
u.CreatedAt = t
}
return nil
}
实际写测试时，最容易被忽略的是对 nil 指针字段和空 JSON 对象（{}）的处理 —— 它们不会触发任何字段赋值，但业务逻辑可能依赖默认零值，这时候需要显式检查字段是否仍为零值而非假设已初始化。 
