在XML处理中，命名空间前缀和URI的映射关系经常让解析逻辑变复杂。XPath提供的namespace-uri-for-prefix()函数，能够直接根据上下文节点和前缀字符串，返回该前缀所绑定的命名空间URI，从而让路径表达式不再依赖写死的地址。
函数基本定义与参数
namespace-uri-for-prefix()属于XPath 2.0及后续版本、XQuery标准中的函数，在XPath 1.0中并不存在。它接收两个参数：第一个是xs:string类型的前缀，第二个是作为命名空间声明上下文的节点。函数会查找该节点及其祖先上对此前缀的声明，并返回对应的URI。
如果传入的前缀是空字符串，函数返回默认命名空间URI；如果前缀未被声明，不同实现可能返回空序列或空字符串。因此在使用前最好做存在性判断，否则后续比较容易出错。
具体调用示例
下面是一段XML，其中定义了前缀atom，我们希望用函数拿到它的URI：
<atom:feed xmlns:atom="http://www.w3.org/2005/Atom"> <atom:title>示例</atom:title> </atom:feed>
在支持XPath 2.0的环境中，可以这样写表达式：
namespace-uri-for-prefix('atom', /atom:feed)
该表达式会返回字符串http://www.w3.org/2005/Atom。我们也可以把它用在谓词中，筛选特定命名空间下的元素：
//*[namespace-uri-for-prefix('atom', .) = 'http://www.w3.org/2005/Atom']
与local-name()配合的实用写法
当XML结构复杂、前缀可能变化时，只比对本地名并不稳妥，因为不同命名空间可能有相同本地名。结合本函数可以判断URI来源：
//*[local-name() = 'title'
and namespace-uri-for-prefix(substring-before(name(), ':'), .)
= 'http://www.w3.org/2005/Atom']
这种写法在解析第三方RSS或Atom订阅源时很常见。它避免将URI硬编码在表达式里，而是动态从文档声明中读取，提升了解析器的适应能力。
不过要注意，substring-before(name(), ':')在无前缀元素上会返回空串，此时函数会取默认命名空间，需要额外用条件排除默认空间干扰。
常见误区与兼容性
不少开发者在XPath 1.0处理器里直接调用该函数，结果报找不到函数。这是因为XPath 1.0没有此函数，只能靠手工在宿主语言里维护前缀映射表，或在XSLT中用namespace::轴提取。
另外，第二个参数必须是节点而非字符串。若传错类型，多数引擎会抛类型错误。在XQuery中，可以用.代表当前节点，但在独立XPath求值器里要明确传入上下文节点对象。
| 场景 | 是否可用 | 说明 |
|---|---|---|
| XPath 1.0 | 否 | 需用宿主语言处理前缀 |
| XPath 2.0 | 是 | 标准内置函数 |
| XQuery | 是 | 同XPath 2.0规则 |
在代码中实际调用
以Java配合Saxon引擎为例，可以用如下方式执行带该函数的XPath：
import net.sf.saxon.xpath.XPathFactoryImpl;
import javax.xml.xpath.*;
import org.xml.sax.InputSource;
XPathFactory factory = new XPathFactoryImpl();
XPath xpath = factory.newXPath();
String expr = "namespace-uri-for-prefix('atom', /atom:feed)";
String uri = xpath.evaluate(expr, new InputSource("feed.xml"));
System.out.println(uri);
上面代码假设feed.xml中已声明atom前缀。若文档使用默认命名空间而未给元素加前缀，则应传空串给函数第一个参数来获取默认URI。
掌握namespace-uri-for-prefix()能显著简化带命名空间XML的查询逻辑，尤其在面对多来源、多版本报文时，不必反复修改表达式中的URI常量。
XPathnamespace-uri-for-prefixXML_namespace修改时间：2026-08-08 06:51:11