xml解析失败主因是字段未导出或tag缺失：需首字母大写并加xml tag；命名空间需前缀；属性须加,attr；body需缓存复用；gbk等非utf-8编码须手动转码。
XML请求体解析失败：结构体字段没映射上
Go 的 xml.Unmarshal 默认只识别导出字段（首字母大写），且需显式用 xml tag 标注。常见现象是解析后字段全为零值，但又不报错。
- 确保结构体字段首字母大写，例如
type User struct { Name string `xml:"name"` } - 如果 XML 有命名空间（如
<user></user>），tag 中要带前缀：Name string `xml:"ns:name"`，并提前在根元素中注册该前缀（或改用xml.Name字段手动处理） - 嵌套结构体字段若对应子元素，tag 值不能写成
"user>name"这类路径语法——encoding/xml不支持 XPath，只能一级一级定义结构体 - 空字符串、缺失字段默认不会赋值，可加
omitempty控制序列化，但反向解析时它不影响行为
HTTP 请求体读取后无法重复使用
Go 的 http.Request.Body 是单次读取的 io.ReadCloser，直接传给 xml.Unmarshal 后，后续中间件或日志再想读就得到空内容。
- 先用
io.ReadAll(r.Body)把原始字节存下来，再用bytes.NewReader()构造新 reader 供xml.Unmarshal使用 - 别忘了调用
r.Body.Close()（即使你已经读完了），否则连接可能无法复用 - 如果还要兼容 JSON 或其他格式，建议统一用
io.NopCloser(bytes.NewReader(data))重置 Body，避免污染原请求对象
XML 中的属性 vs 子元素混淆导致解析错误
比如 XML 是 <user id="123"><name>Alice</name></user>，但结构体字段写了 ID string `xml:"id"`，结果 ID 为空——因为默认 xml: tag 匹配的是子元素，不是属性。
- 匹配属性必须显式加
attr后缀：ID string `xml:"id,attr"` - 混合场景下（既有属性又有子元素），结构体字段命名和 tag 要严格区分，例如：
Name string `xml:"name"`和Lang string `xml:"lang,attr"` - 注意属性值类型：XML 属性只能是字符串，数字/布尔需自行转换；而子元素内容可由
UnmarshalXML方法自定义解析逻辑
中文字符乱码或解析 panic：编码没处理
XML 声明里写了 <?xml version="1.0" encoding="GBK"?>，但 Go 默认按 UTF-8 解析，会直接 panic 或读出乱码。
立即学习“go语言免费学习笔记（深入）”；
- Go 标准库不自动转码，必须在解析前手动转换。推荐用
golang.org/x/text/encoding系列包，例如用gbk.NewDecoder().Bytes(data)先转 UTF-8 字节 - 别依赖
strings.ToValidUTF8这类简单替换——它只是删非法字节，不是解码 - 如果不确定编码，可先用
charset.NewReaderLabel（来自golang.org/x/net/html/charset）做探测，但 Web API 场景下更稳妥的是要求客户端统一发 UTF-8
XML 解析真正难的不是语法，而是隐含约束：命名空间、编码、属性/元素语义、空值表示方式。这些地方一错，错误信息往往只报“invalid character”，得靠日志打原始字节才能定位。
