XSLT中document()函数无法通过XPath选取元素的问题求助

核心问题分析 #

你遇到的<documentIdentifier xmlns=""/>空值问题，90%以上是命名空间不匹配导致的，其次是元数据选取逻辑或路径的细节问题，以下是具体排查方向和解决办法：

1. ALTO文件的默认命名空间未处理 #

ALTO标准文件通常带有默认命名空间（比如http://www.loc.gov/standards/alto/ns-v4#），如果XSLT未声明该命名空间，新生成的<documentIdentifier>会脱离ALTO的命名空间，出现xmlns=""，后续XPath选取时因命名空间不匹配无法识别该元素。

解决办法：
在XSLT的根元素<xsl:stylesheet>中声明ALTO命名空间，并指定默认命名空间：

<xsl:stylesheet version="2.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:alto="http://www.loc.gov/standards/alto/ns-v4#"
    xpath-default-namespace="http://www.loc.gov/standards/alto/ns-v4#"
    exclude-result-prefixes="alto">

添加<documentIdentifier>时，要么使用alto:前缀，要么依赖xpath-default-namespace让元素自动继承命名空间，避免出现空命名空间声明。

2. 元数据XML的命名空间未绑定 #

如果你的元数据文件带有自定义命名空间（比如<root xmlns="http://your-meta-uri">），直接用//Heading2会因为命名空间缺失无法匹配到元素，导致返回空值。

解决办法：
在XSLT中声明元数据的命名空间前缀，并用前缀选取元素：

<!-- 在xsl:stylesheet中添加元数据命名空间 -->
xmlns:meta="http://your-meta-uri"

<!-- 匹配元数据时使用前缀 -->
<xsl:variable name="doc-id" select="document('metadata.xml')//meta:Record[meta:FileName = $current-filename]/meta:Heading2"/>

3. 文件名匹配的细节误差 #

确认元数据中<FileName>的内容与ALTO文件名完全一致：

• 检查大小写：比如ALTO文件是Doc_001.xml，元数据里是doc_001.xml，大小写不匹配会导致匹配失败
• 检查扩展名：元数据里是否省略了.xml后缀
• 检查空格：使用normalize-space()去除两端空格，避免隐形空格干扰

优化匹配逻辑：

<xsl:variable name="current-filename" select="normalize-space(tokenize(base-uri(), '/')[last()])"/>
<xsl:variable name="doc-id" select="document('metadata.xml')//meta:Record[normalize-space(meta:FileName) = $current-filename]/meta:Heading2"/>

4. document()函数的路径基准问题 #

部分XSLT处理器中，document()的路径基准是样式表所在目录，而非ALTO文件的目录。如果元数据和ALTO文件不在同一目录，可能导致加载失败。

解决办法：
使用base-uri()获取ALTO文件的绝对路径，拼接元数据路径：

<xsl:variable name="meta-path" select="concat(substring-before(base-uri(), '/'), '/metadata.xml')"/>
<xsl:variable name="doc-id" select="document($meta-path)//meta:Heading2[../meta:FileName = $current-filename]"/>

5. 模板匹配的优先级问题 #

如果XSLT中存在多个匹配ALTO元素的模板，可能导致<documentIdentifier>未被插入到正确位置。确保模板匹配的是ALTO的目标节点（比如<Description>），且优先级正确。

示例完整模板：

<xsl:stylesheet version="2.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:alto="http://www.loc.gov/standards/alto/ns-v4#"
    xmlns:meta="http://your-meta-uri"
    xpath-default-namespace="http://www.loc.gov/standards/alto/ns-v4#"
    exclude-result-prefixes="meta">

    <!-- 复制所有原有节点 -->
    <xsl:template match="@*|node()">
        <xsl:copy>
            <xsl:apply-templates select="@*|node()"/>
        </xsl:copy>
    </xsl:template>

    <!-- 在Description节点下插入documentIdentifier -->
    <xsl:template match="Description">
        <xsl:copy>
            <xsl:apply-templates select="@*|node()"/>
            <xsl:variable name="current-filename" select="normalize-space(tokenize(base-uri(), '/')[last()])"/>
            <xsl:variable name="doc-id" select="document('metadata.xml')//meta:Record[normalize-space(meta:FileName) = $current-filename]/meta:Heading2"/>
            <documentIdentifier>
                <xsl:value-of select="$doc-id"/>
            </documentIdentifier>
        </xsl:copy>
    </xsl:template>
</xsl:stylesheet>

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