最可靠方式是用documentbuilder解析xml后手写递归函数转map：属性加@前缀、文本用#text键、空元素设为null，需过滤非element_node、合并text_node、单独处理attribute。
用 DocumentBuilder 解析 XML 字符串再递归转 Map 最可靠
Java 原生没有直接把 XML 转成嵌套 Map 的标准 API，硬套 JAXB 或第三方库（比如 xmltojson）容易在属性/文本混用、同名子节点、空元素等场景翻车。最可控的方式是自己用 DocumentBuilder 解析成 Document，再写一个轻量递归函数遍历节点。
关键不是“能不能转”，而是“怎么让 <user id="123"><name>Tom</name></user> 变成 {"user": {"@id": "123", "name": "Tom"}} 这种结构——属性加 @ 前缀、文本内容用 #text 键、子节点自动嵌套，都得手动约定清楚。
- 别用
SAXParser：回调式写法对嵌套结构维护成本高，容易漏层级 - 别跳过
DocumentBuilder.setFeature("http://apache.org/xml/features/disallow-doctype-decl", true)：防 XXE 攻击，尤其输入不可信时 - 空元素如
<email></email>建议统一转成{"email": null}，而不是忽略或空字符串，否则下游map.get("email") == null语义模糊
parseNode 递归函数里必须处理三类节点：Element、Text、Attribute
XML 节点类型不只有 Element，Text 节点（即标签内纯文本）和 Attribute（属性）必须分开处理，否则会把属性值当子节点、把换行当内容。
典型错误是只遍历 getChildNodes()，结果把文本节点（含缩进和换行）也塞进 Map，造成 {"#text": "\n "} 这种脏数据。
- 用
node.getNodeType() == Node.ELEMENT_NODE过滤，跳过TEXT_NODE、COMMENT_NODE - 属性用
element.getAttributes()单独取，每个Attr的 key 是"@" + attr.getName()，value 是attr.getValue() - 元素内的纯文本（非子标签）要合并：遍历所有直接子
TEXT_NODE，trim()后拼接，空则设为null，键固定为"#text"
示例片段：
private Map<string object> parseNode(Node node) {
if (node.getNodeType() != Node.ELEMENT_NODE) return Collections.emptyMap();
Element elem = (Element) node;
Map<string object> map = new LinkedHashMap();
// 处理属性
NamedNodeMap attrs = elem.getAttributes();
for (int i = 0; i
<h3>同名子节点（如多个 <code><item></item></code>）必须转成 <code>List</code>，不能覆盖</h3>
<p>这是最容易被忽略的坑：XML 允许多个同名子节点，但 <code>Map</code> 的 key 是唯一的。如果代码里直接 <code>map.put("item", value)</code>，后一个会覆盖前一个，数据直接丢。</p>
<p>判断逻辑很简单——插入前先查 key 是否已存在。但要注意，第一次是单个 <code>Object</code>，第二次才升格为 <code>List<object></object></code>，第三次往 list 里 add 就行。</p>
<ul>
<li>别用 <code>instanceof ArrayList</code> 判定，用 <code>map.get(key) instanceof List</code> 更稳妥</li>
<li>如果业务确定某个标签永远只有一个，可加白名单跳过 list 化（比如 <code>"config"</code>），但默认行为必须保守</li>
<li>测试用例一定要包含 <code><list><item>a</item><item>b</item></list></code>，验证输出是 <code>{"list": {"item": ["a", "b"]}}</code>
</li>
</ul>
<h3>字符编码和命名空间不处理会导致解析失败或乱码</h3>
<p>XML 声明里带 <code>encoding="GBK"</code>，但 <code>DocumentBuilder</code> 默认按 UTF-8 读，字节流一解码就错；还有带命名空间的 XML（<code><root xmlns:ns="http://example.com"></root></code>），不设置 <code>setNamespaceAware(true)</code>，<code>getNodeName()</code> 返回的是 <code>ns:root</code> 还是 <code>root</code> 都不确定。</p>
<ul>
<li>构造 <code>InputSource</code> 时显式指定编码：<pre class="brush:php;toolbar:false;">InputSource src = new InputSource(new ByteArrayInputStream(xmlBytes));
src.setEncoding("UTF-8"); // 或从 XML 声明里动态提取
dbFactory.setNamespaceAware(true)，否则带前缀的标签名解析异常，且 getAttributes() 可能漏掉命名空间声明属性复杂点在于，真实 XML 往往混合了 CDATA、实体引用（<）、注释，这些在 getTextContent() 中已自动解码，但如果你改用 getNodeValue() 就会拿到原始未解码字符串——这点很容易被忽略，导致 显示成字面量。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
