xml.Unmarshal 不适合解析大 XML 文件，因其需加载全量数据构建 DOM 树，导致内存激增和 GC 压力；应使用 xml.Decoder 流式解析配合状态机与批量入库。
别用 xml.Unmarshal 解析大 XML 文件——它会把整个文件加载进内存，100MB 的 XML 很可能吃掉 300MB+ 内存，触发 GC 压力甚至 OOM；真正靠谱的方案是 xml.Decoder 流式解析 + 状态机控制 + 批量入库。
为什么 xml.Unmarshal 在大文件场景下必然失败
它不是“慢”，而是设计上就不适配：必须一次性读完全部内容、构建完整 DOM 树再反射赋值。实测一个 80MB 的报表 XML，xml.Unmarshal 占用峰值内存达 260MB，且耗时集中在 GC 阶段；而 xml.Decoder 在同一机器上稳定维持在 4–6MB，解析速度提升 3 倍以上。
常见误判是“XML 结构简单，应该没问题”——错。只要文件体积超过 5MB，就该默认走流式；哪怕只有 <row></row> 重复 50 万次，xml.Unmarshal 仍会把全部 row 实例塞进 slice，内存随行数线性增长。
- 不要对
os.Open后直接传给xml.Unmarshal抱幻想 - HTTP Body 或 gzip 压缩流（如
gzip.NewReader(resp.Body)）更不能绕过Decoder - 配置类小文件（
用 xml.Decoder 提取 <row> 并逐批写入数据库的关键步骤
核心不是“怎么读”，而是“怎么控流 + 怎么攒批”。目标节点（比如 <row>）出现时，立刻调用 decoder.DecodeElement(&r, &se) 局部解析，避免手动拼接字段；每攒够 100 条就 tx.Exec 一次，别等全解析完再提交。
立即学习“go语言免费学习笔记（深入）”；
- 进入
<row>前，先检查t.Name.Local == "row"且t.Name.Space == ""（除非 XML 显式声明了命名空间） - 结构体字段必须首字母大写，且
xml:标签严格匹配属性名，例如XuKeZhengHao string `xml:"XuKeZhengHao,attr"` - 遇到
xml.CharData类型 token，记得strings.TrimSpace(string(t))，否则空格和换行会混进字符串 - 每成功解析一个
row，append 到本地 slice；当 len(slice) == 100 时，用tx.Stmt().Exec(...)批量插入，然后slice = slice[:0]清空 - 别忘了在循环末尾
decoder.Token()消费掉当前 token，否则下次DecodeElement会从错位位置开始
命名空间和属性缺失导致静默失败的排查点
静默失败（字段全零值、没报错但数据为空）90% 出在这里。encoding/xml 不校验命名空间，但会把带 xmlns 的元素归为“不同空间”，导致 t.Name.Local == "row" 匹配失败——因为 t.Name.Space 是那个 URL 字符串，不是空。
- 先用
xmlfmt或浏览器打开 XML，确认是否有xmlns="http://xxx"声明 - 若存在，要么在解析前设
decoder.DefaultSpace = "http://xxx"，要么匹配时写成t.Name.Space == "http://xxx" && t.Name.Local == "row" - 属性字段漏写
,attr是高频错误：比如<row id="123">，字段必须是ID string `xml:"id,attr"`，只写"id"就拿不到值 - 字段类型不匹配（如用
int接收空字符串属性）会导致解析中断，建议统一用*string或sql.NullString
流式解析中提前退出与资源释放的细节
业务逻辑可能只需要前 N 条记录，或遇到特定条件（如某字段值为 "invalid"）就要终止。这时不能直接 return，否则 decoder 内部状态错乱，后续 Token() 调用可能 panic。
- 退出前务必先调一次
decoder.Token()，确保当前 token 已被消费 - 如果用了
os.File，记得defer f.Close()；如果是 HTTP Body，别忘了resp.Body.Close() - 批量插入失败时，要 rollback 当前事务，并返回 error，别让解析继续——流式过程不可逆
- 别在 for 循环里新建
sql.Tx，开销太大；应在最外层 begin，解析完 commit
真正难的不是语法，而是状态同步：token 流、结构体字段绑定、数据库事务边界，三者必须咬合。漏掉一次 DecodeElement 或多调一次 Skip()，后面所有解析都会偏移——这种错不会报错，只会让你查半天数据哪去了。
