Dom4J解析Maven Pom时，如何让XPath查询适配默认命名空间？

嘿，这个问题我太熟悉了！Dom4J对默认命名空间的XPath处理确实有点反直觉，我当初踩过一模一样的坑😂

为什么会出现这个问题？ #

当你的Pom文件添加了默认命名空间（比如xmlns="http://maven.apache.org/POM/4.0.0"），<project>及其所有子元素其实都属于这个命名空间。但XPath的默认规则是：不带前缀的元素默认属于“无命名空间”范畴，所以/project/groupId这类查询会找不到对应的节点。

至于pom.selectSingleNode("/project")能正常工作，那是Dom4J的一个特殊处理——它直接匹配根节点的本地名称，忽略了命名空间的存在，刚好命中了根节点，但子节点就没有这个“特权”了。

正确的解决方法 #

核心思路是：给默认命名空间绑定一个前缀，然后在XPath表达式中使用这个前缀来定位元素。具体步骤如下：

1. 动态获取默认命名空间URI #

从根节点project获取它的命名空间URI，避免硬编码（毕竟不同版本的Pom可能命名空间URI有变化）。

2. 创建命名空间上下文并绑定前缀 #

用Dom4J提供的SimpleNamespaceContext类，把一个自定义前缀（比如pom）绑定到获取到的默认命名空间URI上。

3. 给XPath对象设置命名空间上下文，然后用带前缀的表达式查询 #

下面是完整的代码示例：

import org.dom4j.Document;
import org.dom4j.Node;
import org.dom4j.XPath;
import org.dom4j.io.SAXReader;
import org.dom4j.namespace.SimpleNamespaceContext;

import java.io.File;

public class PomParser {
    public static void main(String[] args) throws Exception {
        SAXReader reader = new SAXReader();
        Document doc = reader.read(new File("pom.xml"));

        // 获取默认命名空间URI
        String defaultNamespaceUri = doc.getRootElement().getNamespaceURI();

        // 创建命名空间上下文，绑定前缀"pom"到默认命名空间
        SimpleNamespaceContext namespaceContext = new SimpleNamespaceContext();
        namespaceContext.addNamespace("pom", defaultNamespaceUri);

        // 创建XPath对象并设置命名空间上下文
        XPath xpath = doc.createXPath("/pom:project/pom:groupId");
        xpath.setNamespaceContext(namespaceContext);

        // 执行查询
        Node groupIdNode = xpath.selectSingleNode(doc);
        if (groupIdNode != null) {
            System.out.println("GroupId: " + groupIdNode.getTextTrim());
        }
    }
}

备选方案（不推荐，仅作补充） #

如果你不想处理命名空间绑定，也可以用XPath的local-name()函数来匹配元素的本地名称，比如：

XPath xpath = doc.createXPath("/*[local-name()='project']/*[local-name()='groupId']");
Node groupIdNode = xpath.selectSingleNode(doc);

这种方式不需要处理命名空间，但表达式会变得冗长且可读性差，尤其是路径较长的时候，所以更推荐第一种命名空间绑定的方式。

内容的提问来源于stack exchange，提问作者neves