Go encoding/xml 解码 Token 时如何识别嵌套结束标签

用 xml.Decoder.Token() 流式读 XML 时，真正容易出错的不是拿到 EndElement，而是判断它结束了哪一层。结论是：让解码器负责保证 XML 令牌合法，应用自己维护一个 []xml.Name 栈；开始标签入栈，结束标签必须和栈顶的 Space + Local 完整匹配后再出栈。

先分清 Token、StartElement 与 EndElement 的边界

Token 返回的接口值可能是 xml.StartElement、xml.EndElement、xml.CharData、注释、处理指令或指令节点。遇到输入末尾时，它返回 nil, io.EOF。自闭合标签例如 也会被展开为连续的开始和结束令牌，所以不能把“看见开始标签”直接当成有子节点。

标准库的 Token 会保证开始与结束元素正确嵌套；如果遇到意外结束标签，或输入在所有元素结束前就 EOF，会返回错误。这个保证解决了“XML 是否合规”，却没有替应用回答“当前结束的是我关心的哪一个节点”。后一个问题要用深度或栈解决。

用栈追踪嵌套结束标签，别只比较 Local

下面的遍历器把每个开始标签压入栈，遇到结束标签时检查栈顶。示例没有运行外部命令，只展示流式读取时的边界逻辑；真实业务可以在开始标签处决定是否读取属性，在结束标签处提交一个完整节点。

package main

import (
    "encoding/xml"
    "fmt"
    "io"
)

func walkXML(r io.Reader) error {
    dec := xml.NewDecoder(r)
    stack := make([]xml.Name, 0, 8)

    for {
        tok, err := dec.Token()
        if err == io.EOF {
            // 只有所有开始标签都已闭合，EOF 才代表正常结束。
            if len(stack) != 0 {
                return fmt.Errorf("XML 提前结束，仍有 %d 层未闭合", len(stack))
            }
            return nil
        }
        if err != nil {
            // 语法错误、字符集错误等由 Token 原样交给调用方处理。
            return err
        }

        switch t := tok.(type) {
        case xml.StartElement:
            // Name 同时保留命名空间和本地名，避免同名元素混层。
            stack = append(stack, t.Name)

        case xml.EndElement:
            if len(stack) == 0 {
                return fmt.Errorf("多出的结束标签: %s", t.Name.Local)
            }
            opened := stack[len(stack)-1]
            if opened != t.Name {
                return fmt.Errorf("结束标签 %s 与开始标签 %s 不匹配", t.Name.Local, opened.Local)
            }
            // 栈顶就是当前 EndElement 对应的开始标签。
            stack = stack[:len(stack)-1]
        }
    }
}

判断重点有三个。第一，EndElement 只能和栈顶比较，不能在整个栈里搜索一个“看起来一样”的名称，否则错误结构会被掩盖。第二，xml.Name 的 Space 是命名空间标识，Local 才是本地名；两者一起比较才是完整身份。第三，io.EOF 不是“读到一半也算成功”，它只有在栈已经为空时才表示完整文档结束。

用深度判断目标节点，用完整名称确认安全边界

如果业务只关心某个 节点，可以在命中开始标签时记录当前栈深度，之后只处理同一层级的字段；当栈顶名称匹配并回到记录开始前的深度时，才提交这条记录。不要只用一个布尔值，因为 record 内还可能嵌套另一个同名元素。

还要注意令牌中的字节切片只在下一次调用 Token 前有效。如果要把字符数据或令牌留到后面处理，应复制它；只保存 xml.Name 这类字符串字段则不会遇到同样的内部缓冲区生命周期问题。

常见问题

为什么不直接比较 EndElement.Name.Local？

不同命名空间可以拥有相同的本地名。比较整个 xml.Name 才能避免把两个业务节点误认为同一个节点。

自闭合标签需要单独写一套判断吗？

通常不需要。Token 会把它展开成开始和结束两个令牌，统一的入栈、栈顶匹配和出栈逻辑即可处理。

Token 已经保证嵌套正确，为什么还要维护栈？

标准库保证解析结果合法，但业务仍需要知道当前深度、某个节点何时完整结束，以及是否该提交一条记录。栈是业务边界状态，不是替代 XML 解析器。