本文详解 Go 语言中对含内嵌结构体的结构进行 JSON 反序列化时的常见陷阱，指出自定义 UnmarshalJSON 方法会覆盖默认行为导致字段丢失，并提供两种简洁、标准、可维护的解决方案：使用结构体标签（struct tags）和显式组合字段。
本文详解 go 语言中对含内嵌结构体的结构进行 json 反序列化时的常见陷阱，指出自定义 `unmarshaljson` 方法会覆盖默认行为导致字段丢失，并提供两种简洁、标准、可维护的解决方案：使用结构体标签（struct tags）和显式组合字段。
在 Go 中，当结构体包含内嵌（anonymous）字段并同时定义了自定义 UnmarshalJSON 方法时，json.Unmarshal 会完全委托给该方法处理整个 JSON 数据，而不再执行默认的字段映射逻辑——这正是问题的根本原因。如示例所示，Outer 结构体内嵌 Inner 并为其定义了 UnmarshalJSON，结果 Num 字段被忽略，因为 Inner.UnmarshalJSON 直接将原始字节赋值给了 Data，未解析 JSON 对象结构。
✅ 推荐方案一：优先使用 JSON 标签（最简洁、最符合 Go 惯例）
无需自定义反序列化逻辑时，应直接利用 Go 的标准 JSON 标签机制，让 encoding/json 包自动完成字段映射：
type Outer struct {
Inner `json:",inline"` // 显式声明内嵌字段需内联展开
Num int `json:"num"`
}
type Inner struct {
Data string `json:"data"`
}关键点：
- json:",inline" 标签告诉 json 包将 Inner 的字段“扁平化”到 Outer 的 JSON 层级中；
- 所有字段（包括 Data 和 Num）均通过标准反射机制解析，语义清晰、性能高效、零额外开销；
- 完全兼容 json.Marshal 的对称行为，易于测试与维护。
✅ 示例输入 {"data":"hello","num":42} 将正确解出 Outer{Inner: Inner{Data: "hello"}, Num: 42}。
✅ 推荐方案二：显式组合 + 精确字段控制（适用于复杂嵌套或需定制场景）
当 Inner 本身结构复杂、需独立验证或未来可能复用时，建议放弃内嵌，改用命名字段组合：
type Outer struct {
Data Inner `json:"data"`
Num int `json:"num"`
}
type Inner struct {
Thing string `json:"thing"`
OtherThing int `json:"otherThing"`
}优势：
- 职责分离清晰：Outer 表达整体结构，Inner 封装子域逻辑；
- 若后续确需对 Inner 做定制反序列化（如字段校验、格式转换），可安全添加 Inner.UnmarshalJSON，且不影响 Outer 的其他字段解析；
- 更易文档化、单元测试及 IDE 支持。
⚠️ 注意：仅当业务逻辑明确要求自定义反序列化行为（如兼容多版本 JSON 格式、加密字段解密、时间格式容错等）时，才应实现 UnmarshalJSON；日常开发中滥用该方法是典型反模式，易引发不可预测的解析行为。
总结：Go 的 encoding/json 设计哲学是“约定优于配置”。善用结构体标签（json:"..."）、inline 修饰符和组合模式，能写出更健壮、更易读、更易演进的序列化代码——远胜于过早引入自定义 UnmarshalJSON 带来的复杂性与风险。
