最稳妥方式是用DocumentBuilder手动遍历DOM树构建Map。需判空、处理嵌套、分离属性与文本、标准化非法key、同名标签转ArrayList，避免XStream/JAXB等库因设计目标不同导致的映射失效。
Java里用DocumentBuilder解析XML再手动遍历节点最稳妥
没有“一键转Map”的标准API，硬套第三方库容易在嵌套、属性、文本混合时翻车。自己控制解析流程反而更可控，尤其当XML结构不规范或需自定义键名规则时。
常见错误现象：NullPointerException（没判空子节点）、DOMException: INVALID_CHARACTER_ERR（节点名含非法字符导致Map key失败）、把属性和子元素全塞进同一层Map引发覆盖。
- 先用
DocumentBuilder加载XML字符串或文件，别直接用SAXParser——它不建树，没法递归读子节点 - 递归函数入参必须带当前
Node和当前层级的Map<string object></string>，避免用全局Map被多线程或嵌套冲掉 - 遇到
Element节点：取node.getNodeName()作key；有子元素就新建子Map，有文本内容且无子元素才存value；有getAttributeNodes()就单独提成attr_XXX格式key - 忽略
Text节点的空白换行（node.getTextContent().trim().length() == 0）
别碰XStream或JAXB想省事
它们本质是对象绑定，不是Map映射。强行用XStream.toMap()会把整个XML塞进一个LinkedHashMap，但key是类名+哈希值，value是原始Node对象，根本没法当业务Map用。
使用场景错配典型表现：XML里有个<user id="123"><name>Alice</name></user>，你想要{"id":"123", "name":"Alice"}，但JAXB生成的是User实例，还得再反射转一遍——性能损耗+空指针风险翻倍。
立即学习“Java免费学习笔记（深入）”；
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
XStream的fromXML()返回Object，不是Map；设new XStream().allowTypes(new Class[]{Map.class})也只认顶层类型，子结构照样崩 -
JAXBContext.newInstance(Map.class)直接抛JAXBException：Map不是JAXB可绑定类型 - 真要用，得写
@XmlRootElement包装类，再手写toMap()方法——那还不如直接DOM解析
处理重复标签名时，ArrayList比字符串拼接更安全
XML里出现多个同名子元素（比如<item>A</item><item>B</item>）时，简单用put(key, value)只会保留最后一个。有人用逗号拼接字符串，结果数值型字段被转成"1,2,3"，后续解析全错。
正确做法是检测到同名key已存在，且原value不是ArrayList，就把它包进新List；已是List就add()。这样Map里存的是String或ArrayList<string></string>，业务层自己判断类型即可。
- 检查逻辑写在递归写入前：
if (map.containsKey(key) && !(map.get(key) instanceof ArrayList)) - 不要提前把所有
item全查出来再塞List——DOM遍历时顺序就是文档顺序，边遍历边装更省内存 - 如果确定某标签绝不会重复（如
<id></id>），可在配置里标为“单值”，跳过List包装逻辑
中文标签名或特殊字符当key时，HashMap本身没问题，但下游系统可能跪
Java的HashMap支持任意String作key，包括含空格、冒号、中文的节点名。问题出在后续环节：JSON序列化、HTTP参数组装、数据库字段映射时，这些key常被当成非法标识符。
所以解析时就得做标准化，而不是等报错再改。别用正则全局删特殊字符——像<user-name></user-name>删掉短横变成username，和原本的<username></username>就冲突了。
- 推荐策略：非字母数字下划线开头的字符，统一转成
uXXXX（Unicode编码），比如姓名→u59d3u540d，user-name→useru002Dname - 用
Normalizer.normalize(str, Normalizer.Form.NFD)先拆分变音符号，再过滤非ASCII字母数字，比纯正则更准 - 如果明确知道XML来自可信源且下游能吃原样key，就加个开关跳过标准化——别默认开启，容易埋雷
真正麻烦的是混合型节点：既有属性又有子元素还有文本内容，这种结构连XPath都难精准定位。这时候别强求一层Map搞定，该拆成Map<string map object>></string>就拆，强行扁平化只会让调用方天天查日志。
