当 go 结构体嵌入了自带 `unmarshaljson` 方法的类型时，外层结构体自定义反序列化逻辑会意外跳过非嵌入字段——这是由类型别名（`type alias t`）无法屏蔽嵌入方法导致的预期行为，而非 bug。
在 Go 的 JSON 反序列化机制中，json.Unmarshal 会优先调用值类型的 UnmarshalJSON 方法（如果存在）。当你为外层结构体 Foo 和其嵌入字段 EmbeddedStruct 都实现了该方法，并在 Foo.UnmarshalJSON 中使用 type Alias Foo 进行“委托解包”时，看似绕过了递归调用，实则引入了一个关键陷阱：
type Alias Foo 虽不继承 Foo 的方法，但会 自动提升（promote） 嵌入字段 EmbeddedStruct 的 UnmarshalJSON 方法。这意味着：
- json.Unmarshal(from, alias) 实际上会调用 EmbeddedStruct.UnmarshalJSON（因为 Alias 包含 EmbeddedStruct 且该方法可被提升），
- 而 EmbeddedStruct.UnmarshalJSON 只解析 {"EmbeddedField":"embeddedValue"}，完全忽略 "Field": "value"，
- 最终 alias.Field 保持零值（空字符串），导致赋值 *d = Foo(*alias) 后 foo.Field 丢失。
✅ 正确解法：在类型别名中显式屏蔽嵌入字段的方法提升，即用匿名结构体替代命名别名，并内联嵌入字段的原始结构（而非类型），从而彻底断开 UnmarshalJSON 的提升链：
func (d *Foo) UnmarshalJSON(data []byte) error {
// 使用匿名结构体，显式内联 EmbeddedStruct 字段（不嵌入类型！）
type Alias struct {
EmbeddedField string `json:"EmbeddedField"`
Field string `json:"Field"`
}
var alias Alias
if err := json.Unmarshal(data, &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 —— 它仍会提升嵌入字段的方法；
- 若嵌入结构体字段较多或需复用逻辑，可将 EmbeddedStruct 的 JSON 字段提取为独立字段（如上），或改用组合而非嵌入；
- 若必须保留嵌入结构体的完整语义，可在 Alias 中显式声明同名字段并忽略嵌入（如 EmbeddedStruct json.RawMessage + 手动解析），但会牺牲部分简洁性；
- json.RawMessage 是处理复杂嵌入反序列化的进阶方案，适用于需延迟解析或动态结构场景。
总结：Go 的嵌入机制与 JSON 方法查找共同作用，使“类型别名绕过递归”的惯用法在此失效。根本解决思路是放弃对嵌入类型的直接委托，转为显式、扁平化的字段控制——这不仅规避了方法提升陷阱，也提升了反序列化逻辑的可读性与可维护性。
