DOM4J解析XML常见问题及解决方案：路径错误优先用getResourceAsStream()、中文路径需显式设UTF-8编码；手动映射Java对象需逐节点取值并判空；SAXReader用于解析，DocumentHelper用于构建；大文件应换SAX/StAX流式处理。
DOM4J读取XML文件时抛出DocumentException怎么办
多数报错不是因为XML格式错，而是路径或编码没对上。常见现象是用new SAXReader().read("config.xml")却提示找不到文件——这时config.xml默认按当前工作目录（不是类路径）查找。
- 优先用
Thread.currentThread().getContextClassLoader().getResourceAsStream("config.xml")加载类路径下的文件 - 若必须用文件路径，确保传入
File对象而非字符串：reader.read(new File("/absolute/path/config.xml")) - 中文路径或含空格时，
getResourceAsStream()比字符串路径更稳；若仍乱码，显式设置reader.setEncoding("UTF-8")
如何用DOM4J把<user id="101"><name>Alice</name><age>28</age></user>转成Java对象
DOM4J本身不提供全自动ORM映射，得手动提取节点值。别被“解析XML映射”误导，它没有像Jackson处理JSON那样的注解驱动反序列化。
- 先用
element.element("name").getTextTrim()取文本，用element.attributeValue("id")取属性值 - 注意
getText()会保留换行和空格，getTextTrim()才等效于trim() - 如果
<age>可能为空，别直接Integer.parseInt(...)，先判空再转，否则NumberFormatException - 批量解析时，用
document.getRootElement().elements("user")获取所有同名子元素列表
SAXReader和DocumentHelper该选哪个来构造XML
读取已有XML用SAXReader，运行时动态生成XML用DocumentHelper。二者定位不同，混用会导致逻辑混乱。
-
SAXReader：只负责解析，返回Document，不能新建节点 -
DocumentHelper：提供createDocument()、createElement()等工厂方法，适合组装XML - 想给现有XML追加节点？先用
SAXReader读出Document，再调用document.getRootElement().addElement("newChild") - 频繁拼接XML字符串？别用
DocumentHelper反复创建——先建好Document，再复用addAttribute()和setText()
Document document = DocumentHelper.createDocument();
Element root = document.addElement("users");
Element user = root.addElement("user").addAttribute("id", "101");
user.addElement("name").setText("Alice");
user.addElement("age").setText("28");
// 输出：<users><user id="101"><name>Alice</name><age>28</age></user></users>
DOM4J解析大XML文件内存爆掉怎么破
DOM4J是DOM模型，整棵树进内存。百MB级XML极易触发OutOfMemoryError，这不是配置能救的，得换策略。
立即学习“Java免费学习笔记（深入）”；
- 确认是否真需要随机访问——如果只是顺序提取某些字段，改用
SAXContentHandler或StAX（如XMLStreamReader） - 非要用DOM4J？至少设
reader.setIgnoreComments(true)和reader.setIgnoreWhitespace(true)减负 - 用
Element.nodeIterator()代替Element.elements()可延迟加载子节点，但根元素仍全在内存 - 生产环境处理大XML，建议直接切到
Woodstox或XStream流式方案，DOM4J不适合这个量级
