本文详解 go encoding/xml 包中自定义 unmarshalxml 方法的正确实现方式，重点解决因递归调用导致的栈溢出问题，并提供可直接复用的结构体与方法示例。
本文详解 go encoding/xml 包中自定义 unmarshalxml 方法的正确实现方式，重点解决因递归调用导致的栈溢出问题，并提供可直接复用的结构体与方法示例。
在 Go 中处理 XML 时，若需完整保留某节点的原始子 XML 字符串（inner XML）及其全部属性，常会尝试重写 UnmarshalXML 方法。但一个典型误区是：在自定义方法中直接调用 d.DecodeElement(&v, &start)，而该方法内部又会再次触发 v.UnmarshalXML(...)——从而形成无限递归，最终引发 stack overflow（栈溢出），错误信息如 runtime: goroutine stack exceeds 1000000000-byte limit。
根本原因在于：xml.Decoder.DecodeElement 是通用反序列化入口，它会检查目标值是否实现了 xml.Unmarshaler 接口；若已实现，则无条件回调该方法——此时若未做终止逻辑，便进入死循环。
✅ 正确做法是：仅对目标字段进行一次解码，且避免再次触发自身方法。关键在于使用 d.DecodeElement 时传入一个非自定义反序列化的中间载体（如 *string、[]byte 或匿名结构体），而非当前类型本身。
以下是一个生产就绪的实现方案：
type InnerXML struct {
XMLName xml.Name
Attrs map[string]string // 存储所有属性（key=Local名，value=值）
Value string // 原始 inner XML 字符串（含标签）
}
func (i *InnerXML) UnmarshalXML(d *xml.Decoder, start xml.StartElement) error {
// 1. 保存节点名和所有属性
i.XMLName = start.Name
i.Attrs = make(map[string]string, len(start.Attr))
for _, attr := range start.Attr {
i.Attrs[attr.Name.Local] = attr.Value
}
// 2. 安全获取 inner XML 原始内容（不含起始/结束标签）
// 使用 bytes.Buffer 避免字符串拼接开销，并支持嵌套结构
var buf bytes.Buffer
if err := d.DecodeElement(&buf, &start); err != nil {
return err
}
i.Value = buf.String()
return nil
}? 注意事项：
- ❌ 切勿在 UnmarshalXML 中对同类型变量调用 d.DecodeElement(&sameTypeVar, &start)；
- ✅ 推荐使用 bytes.Buffer 或 *string 作为中间载体，DecodeElement 对基础类型或标准库类型（如 bytes.Buffer）不会触发自定义方法；
- ⚠️ 若需进一步解析 Value 中的 XML（例如提取子元素），应另行调用 xml.Unmarshal，而非在当前 UnmarshalXML 中嵌套解析；
- ? 属性名建议统一使用 attr.Name.Local（忽略命名空间前缀），如需完整命名空间支持，可改用 attr.Name.Space + ":" + attr.Name.Local。
完整可运行示例见 Go Playground（已验证无栈溢出）。该方案兼顾安全性、可读性与扩展性，适用于配置解析、XML 桥接、元数据提取等场景。
