Dom4j读取XML报NoClassDefFoundError需添加jaxen 1.2.0依赖；中文路径失败应改用FileInputStream或类路径加载；parseText()仅适用于字符串场景，写回文件须显式设置OutputFormat编码。
Dom4j读取XML文件时抛出NoClassDefFoundError: org/jaxen/JaxenException
这是Dom4j最常踩的坑——它依赖jaxen做XPath解析，但Maven默认不带这个依赖。没加就会在调用selectNodes()或evaluate()时崩。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用Maven的话，必须显式添加
jaxen依赖，版本选1.2.0（和dom4j 2.1.x兼容） - 如果只用基础DOM遍历（比如
element.element("xxx")），可以不加jaxen，但一旦写XPath就立刻报错 - 注意别引入
jaxen-1.1-beta-6这种老版本，和JDK 8+有反射兼容问题
用SAXReader读取中文路径或含空格的XML文件失败
Windows下常见错误：java.io.FileNotFoundException: D:my projectconfig.xml (系统找不到指定的路径)，其实是URL编码问题，不是路径真丢了。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 别直接传
new File("D:\my project\config.xml").toURI().toString()——这会产生file:///D:/my%20project/config.xml，而SAXReader.read()对%20解码失败 - 正确做法是用
new FileInputStream(new File("D:\my project\config.xml"))，绕过URI解析 - 或者统一用类路径加载：
Thread.currentThread().getContextClassLoader().getResourceAsStream("config.xml")，更稳
DocumentHelper.parseText() vs SAXReader.read()怎么选
前者吃字符串，后者吃文件/流/URL；看起来差不多，但行为差异直接影响健壮性。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 从文件读：无条件用
SAXReader.read()，它自动识别编码（支持<?xml version="1.0" encoding="GBK"?>声明） -
parseText()只适合测试或拼接XML字符串场景，且不会处理BOM、编码声明，遇到GBK内容极易乱码 - 如果XML来自HTTP响应体，先确保
InputStream已按响应头Content-Type指定编码读成String，再喂给parseText()，否则白忙
解析后修改节点再写回文件，中文变问号或乱码
不是Dom4j的问题，是XMLWriter默认用UTF-8写，但没设输出编码声明，或目标文件原编码是GBK。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 写回前必须配
OutputFormat：OutputFormat.createPrettyPrint().setEncoding("GBK")（按原始文件编码来） - 别用
document.write(...)，改用XMLWriter构造时传OutputStreamWriter并指定编码 - 如果原XML没声明
encoding，Dom4j读取时会按UTF-8猜，此时写回必须保持一致，否则编辑器打开就乱
真正麻烦的是混合编码场景：配置文件是GBK，但用户上传的XML片段是UTF-8。这时候得在解析前先探测BOM或前几百字节，不能全靠SAXReader自动猜。
