json.unmarshal不返回解析结果,只返回error;必须传结构体指针,字段需大写且合理使用json tag;null设零值或nil,缺失字段不修改,类型不匹配则跳过。

json.Unmarshal 的返回值不是解析结果,而是错误信号
json.Unmarshal 不会把解析好的数据“返回”给你,它只负责把数据写进你传进去的变量里,并告诉你“有没有出错”。它的返回值是 error:等于 nil 表示成功,非 nil 表示失败——仅此而已。
常见错误现象:
• 打印 err 是 nil 就以为“没解析出东西”,其实 p 已被填满,只是你没看它;
• 传了 p 而不是 &p,导致编译通过但解析静默失败(结构体字段全零值);
• 忘记检查 err,线上 JSON 字段名拼错或类型不匹配时直接用零值继续跑逻辑。
- 必须传指针:
json.Unmarshal(data, &p),否则什么都不会写入 - 解析后立刻验证:
fmt.Printf("→ %+v", p),别只盯着err - 调试时可加回写验证:
re, _ := json.Marshal(p); fmt.Println(string(re)),确认是否还原一致
结构体字段必须可导出,且注意 json tag 的优先级
Go 的 json 包只处理首字母大写的字段(即“可导出”字段)。小写字母开头的字段,比如 sex string,无论有没有 json:"sex" 标签,都不会被编码或解码。
使用场景:对接外部 API 时,字段名常是 user_id、created_at 这类下划线风格,而 Go 习惯用 UserID、CreatedAt,这时 json tag 就是桥梁。
- 标签优先于字段名:
Name string `json:"name"`→ JSON 中 key 是"name",不是"Name" - 字段不可导出 → 完全忽略,不会报错也不会赋值
- 嵌套结构体也一样:内部字段同样要大写 + 合理 tag,否则深层字段丢失
遇到 null、缺失字段或类型不匹配时,Unmarshal 怎么处理
json.Unmarshal 对容错有明确策略:遇到 JSON null,会把对应字段设为 Go 零值(nil 指针、空切片、空 map);遇到字段缺失,默认不修改目标变量;遇到类型不匹配(比如 JSON 字符串往 int 字段塞),则跳过该字段,继续解析其余部分。
性能 / 兼容性影响:这种“尽力而为”策略让解析不易崩,但也容易掩盖问题——比如后端悄悄改了字段类型,前端没报错,但业务逻辑用了零值。
- 指针字段接收
null→ 变成nil,适合表示“可选”语义 - 普通字段(如
int)收到null→ 保持原值(若未初始化就是0) - 想强制校验字段存在?得自己加逻辑,比如解析后检查
p.Name == ""并报错
需要自定义解析逻辑?实现 UnmarshalJSON 方法
标准 Unmarshal 处理不了的情况:时间格式不统一("2024-01-01")、字段需动态计算("op": "+" → 算出 <code>Result)、或 JSON 结构和 Go 类型不一一对应(比如一个字段有时是字符串、有时是对象)。
这时就得让结构体实现 UnmarshalJSON 方法,但要注意递归陷阱:不能在方法里直接调用 json.Unmarshal(data, &s),否则无限循环。
- 必须用类型别名绕过:
type Alias MyStruct,再对Alias解析 - 编译时可加断言确保接口实现:
var _ json.Unmarshaler = (*MyStruct)(nil) - 别忘了处理异常分支:比如时间解析失败要 return error,不能静默吞掉
最常被忽略的一点:json.Unmarshal 是“写入式”操作,它从不返回数据。你真正要关心的,永远是你传进去的那个变量本身,而不是函数返回值。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











