Java中XPath命名空间配置需在XPath实例上调用setNamespaceContext()设置自定义NamespaceContext实现，而非XPathFactory；必须在evaluate()前完成，否则带前缀表达式解析失败。
Java中使用XPathFactory设置命名空间上下文，核心在于为XPath对象配置一个实现了NamespaceContext接口的实例，而不是直接在XPathFactory上设置——XPathFactory本身不处理命名空间，真正的命名空间绑定发生在XPath对象创建后、执行查询前。
1. 创建自定义NamespaceContext实现类
标准做法是编写一个内部类或工具类，实现javax.xml.namespace.NamespaceContext接口，重写getNamespaceURI(String prefix)、getPrefix(String namespaceURI)和getPrefixes(String namespaceURI)三个方法。其中只有getNamespaceURI在XPath求值时被实际调用。
常见简化写法（仅支持前缀→URI映射）：
public class SimpleNamespaceContext implements NamespaceContext {
private final Map<String, String> nsMap = new HashMap<>();
public SimpleNamespaceContext(Map<String, String> nsMap) {
this.nsMap.putAll(nsMap);
}
@Override
public String getNamespaceURI(String prefix) {
return nsMap.getOrDefault(prefix, XMLConstants.NULL_NS_URI);
}
@Override
public String getPrefix(String namespaceURI) {
return null; // 通常不需要反向查找
}
@Override
public Iterator<String> getPrefixes(String namespaceURI) {
return Collections.emptyIterator(); // 同上
}
}
2. 构建XPath并设置命名空间上下文
通过XPathFactory获取XPath实例后，调用setNamespaceContext()方法注入上下文。注意：必须在调用evaluate()之前设置，否则带前缀的XPath表达式会解析失败（报org.xml.sax.SAXException: Prefix must be resolved等错误）。
立即学习“Java免费学习笔记（深入）”；
示例代码：
Document doc = ... // 已解析的XML文档（含命名空间声明，如 xmlns:ns="http://example.com/ns"）
XPathFactory factory = XPathFactory.newInstance();
XPath xpath = factory.newXPath();
// 定义命名空间映射
Map<String, String> nsMap = new HashMap<>();
nsMap.put("ns", "http://example.com/ns");
nsMap.put("xsd", "http://www.w3.org/2001/XMLSchema");
xpath.setNamespaceContext(new SimpleNamespaceContext(nsMap));
// 使用带前缀的XPath表达式
String expression = "/ns:root/ns:item[@type='book']/ns:title";
String title = xpath.evaluate(expression, doc);
3. 使用XPathConstants.NODESET处理带命名空间的节点集合
当查询返回多个节点（如NodeList）时，确保XPath表达式中的前缀与NamespaceContext中注册的一致。若XML中默认命名空间（xmlns="..."）存在，需为其显式指定一个前缀（如def），并在上下文中映射该前缀到对应URI——XPath不支持无前缀的默认命名空间匹配。
- ❌ 错误：XPath写成
//item去匹配<item xmlns="http://a.b/c">→ 不会命中 - ✅ 正确：注册前缀
def → "http://a.b/c"，XPath写成//def:item
4. 注意事项与常见问题
- XPathFactory无需配置命名空间，它是线程安全的工厂类，只负责生成XPath实例
- 每个XPath实例可独立设置不同的NamespaceContext，适合多命名空间场景
- 若XML文档未声明命名空间但XPath用了前缀，会抛出
XPathExpressionException - JDK 9+中推荐使用
XPathFactory.newInstance(XPathFactory.DEFAULT_OBJECT_MODEL_URI)明确指定模型
