当 go 结构体嵌入了带有自定义 `unmarshaljson` 方法的类型时，外层结构体若也实现该方法，需谨慎处理别名类型（alias type）以避免嵌入类型的 `unmarshaljson` 被意外继承，否则会导致字段丢失。
在 Go 的 JSON 反序列化机制中，json.Unmarshal 对实现了 UnmarshalJSON 接口的类型会优先调用其自定义方法；而当该方法内部使用别名类型（如 type Alias Foo）进行递归反序列化时，必须确保该别名完全剥离所有方法——包括嵌入字段所“提升”（promoted）的方法。
问题核心在于：type Alias Foo 确实不继承 Foo 自身的方法（防止无限递归），但它仍会继承嵌入字段 EmbeddedStruct 所提供的 UnmarshalJSON 方法（因为 Go 的字段提升规则对别名类型同样生效）。因此，json.Unmarshal(from, alias) 实际调用的是 EmbeddedStruct.UnmarshalJSON，而非默认的结构体字段映射逻辑，导致外层字段（如 Field）被忽略。
✅ 正确做法是：在 Foo.UnmarshalJSON 中，为别名显式声明一个空结构体，彻底隔离嵌入类型的自定义反序列化行为：
func (d *Foo) UnmarshalJSON(from []byte) error {
fmt.Printf("Foo.UnmarshalJSON\n")
// 关键：定义无嵌入、无方法的纯数据别名
type Alias struct {
EmbeddedField string `json:"EmbeddedField"`
Field string `json:"Field"`
}
var alias Alias
if err := json.Unmarshal(from, &alias); err != nil {
return fmt.Errorf("failed to unmarshal Foo: %w", err)
}
// 手动赋值（或通过组合还原）
d.EmbeddedField = alias.EmbeddedField
d.Field = alias.Field
return nil
}⚠️ 注意事项：
- 不要依赖 type Alias Foo —— 它会隐式携带嵌入类型的 UnmarshalJSON，破坏预期行为；
- 若嵌入结构体字段较多或需复用逻辑，可将 EmbeddedStruct 的反序列化提取为独立函数（不依赖方法），并在 Foo.UnmarshalJSON 中显式调用；
- 始终使用 &alias 传参给 json.Unmarshal，避免值拷贝导致解包失败；
- 测试时建议覆盖边界场景：缺失字段、空 JSON 对象、嵌套结构等。
? 总结：Go 的嵌入与方法提升机制在自定义反序列化中是一把双刃剑。安全实践是——在别名中放弃结构体继承，改用显式字段定义，从而获得完全可控的 JSON 映射行为。这不仅规避了方法冲突，也提升了代码可读性与可维护性。
