Dom4j XPath查不到带命名空间的元素是因为未设置NamespaceContext；必须用SimpleNamespaceContext显式注册前缀与URI映射，并在创建XPath后、查询前调用setNamespaceContext()，否则带前缀的XPath始终返回空。
Dom4j XPath查不到带命名空间的元素？先确认是否设置了 NamespaceContext
Dom4j 默认不自动识别 XML 命名空间，selectNodes() 或 selectSingleNode() 用 XPath 查带 xmlns 的节点时，十有八九返回空——不是 XPath 写错了，是根本没告诉 Dom4j “这个前缀对应哪个 URI”。
必须显式设置 NamespaceContext，否则所有带前缀的 XPath（比如 //ns:book）都会失效。
- 别指望靠
document.getRootElement().getNamespace()自动推导；Dom4j 不会把根命名空间“透传”给 XPath 引擎 - 不能只调用
document.valueOf("//ns:title")就完事——没上下文，ns就是个未声明的前缀，直接抛org.dom4j.XPathException - 设置时机很重要：必须在创建 XPath 对象后、执行查询前调用
setNamespaceContext()
怎么写一个能用的 NamespaceContext 实现？别手写类，用 SimpleNamespaceContext
自己实现 NamespaceContext 接口容易漏掉 getPrefixes(String) 方法，导致某些 XPath 引擎（尤其是老版本 Dom4j）内部报 UnsupportedOperationException。推荐直接用 org.dom4j.io.SimpleNamespaceContext ——它已预置好完整行为。
示例：假设 XML 是 <root xmlns:ns="http://example.com/ns"><item>abc</item></root>
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
立即学习“Java免费学习笔记（深入）”；
SimpleNamespaceContext nsContext = new SimpleNamespaceContext();
nsContext.addNamespace("ns", "http://example.com/ns");
XPath xpath = document.createXPath("//ns:item");
xpath.setNamespaceContext(nsContext);
List<Node> nodes = xpath.selectNodes(document);
XPath 表达式里前缀必须和 NamespaceContext 里注册的一致
大小写敏感，且不能省略。比如注册了 ns → http://example.com/ns，那 //NS:item 或 //item 都查不到——前者前缀不匹配，后者没声明命名空间。
- 默认命名空间（
xmlns="http://example.com/ns"）不能用空字符串前缀注册；得用一个显式前缀（如def），然后在 XPath 里写//def:item - 如果 XML 有多个命名空间，每个都得
addNamespace()一次，前缀不能重复 - 不要试图用
local-name()=绕过命名空间（如//*[local-name()='item']）——虽然能查到，但失去语义且性能差，DOM 树大时明显变慢
用 SAXReader 加载时设置 namespaceAware=true 不够
SAXReader 的 setFeature("http://xml.org/sax/features/namespaces", true) 只影响解析阶段是否保留命名空间信息，不影响 XPath 查询逻辑。即使开了这个，XPath 还是需要独立的 NamespaceContext。
- 常见误操作：以为设了
namespaceAware=true就万事大吉，结果 XPath 仍为空 - 更隐蔽的坑：某些 IDE 或构建工具（如旧版 Maven Surefire）可能默认禁用 SAX 特性，需显式检查
reader.getFeature("http://xml.org/sax/features/namespaces")返回值 - 如果你用的是 Dom4j 2.1+，注意
SimpleNamespaceContext在org.dom4j.io包下，不是org.jdom2或其他类似包
setNamespaceContext() 或前缀/URI 对不上，查出来永远是空——这点比语法错误还难 debug，因为不报异常，只静默失败。 
