XSLT-1无法从导入文档查找XML值的问题求助

常见问题原因及排查步骤 #

1. 翻译XML加载路径错误 #

确认使用document()函数加载翻译文件时路径正确，路径需相对于当前XSL文件或使用绝对路径：

<!-- 错误示例：路径错误导致无法加载翻译文件 -->
<xsl:variable name="translations" select="document('invalid-path/translations.xml')"/>

<!-- 正确示例：使用正确相对路径 -->
<xsl:variable name="translations" select="document('./translations.xml')"/>

2. XPath上下文节点错误 #

获取翻译标题时，需确保XPath基于翻译文件的根节点，而非当前输入XML的节点。假设翻译XML结构如下：

<Translations>
  <Translation LangCode="en">
    <Title>English Main Title</Title>
  </Translation>
  <Translation LangCode="fr">
    <Title>Titre Principal Français</Title>
  </Translation>
</Translations>

错误与正确的XPath写法对比：

<!-- 错误示例：上下文为当前输入XML节点，无法匹配翻译 -->
<h1><xsl:value-of select="Translation[@LangCode=$lang]/Title"/></h1>

<!-- 正确示例：基于翻译变量的根节点查询 -->
<xsl:variable name="lang" select="/Root/LangCode"/>
<h1><xsl:value-of select="$translations/Translations/Translation[@LangCode=$lang]/Title"/></h1>

3. LangCode变量取值错误 #

确保LangCode变量获取的是文本值而非节点对象，避免匹配失败：

<!-- 正确写法：明确取文本值 -->
<xsl:variable name="lang" select="/Root/LangCode/text()"/>

<!-- 错误写法：直接取节点，可能导致匹配逻辑失效 -->
<xsl:variable name="lang" select="/Root/LangCode"/>

4. 模板匹配优先级冲突 #

若存在多个模板匹配<h1>或相关节点，可通过priority属性指定优先级，确保目标模板被优先调用：

<xsl:template match="h1" priority="1">
  <h1>
    <xsl:value-of select="$translations/Translations/Translation[@LangCode=$lang]/Title"/>
  </h1>
</xsl:template>

完整可验证示例 #

输入XML（input.xml）：

<Page>
  <LangCode>en</LangCode>
</Page>

翻译XML（translations.xml）：

<Translations>
  <Translation LangCode="en">
    <MainTitle>Home Page</MainTitle>
  </Translation>
  <Translation LangCode="es">
    <MainTitle>Página Principal</MainTitle>
  </Translation>
</Translations>

XSLT代码（transform.xsl）：

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:variable name="translations" select="document('translations.xml')"/>
  <xsl:variable name="lang" select="/Page/LangCode/text()"/>

  <xsl:template match="/">
    <html>
      <body>
        <h1><xsl:value-of select="$translations/Translations/Translation[@LangCode=$lang]/MainTitle"/></h1>
        <h2><xsl:value-of select="$lang"/></h2>
      </body>
    </html>
  </xsl:template>
</xsl:stylesheet>

执行转换后会输出预期结果：

<html>
  <body>
    <h1>Home Page</h1>
    <h2>en</h2>
  </body>
</html>

总结 #

• 优先确认翻译文件的加载路径正确性
• 验证XPath表达式的上下文和节点指向是否准确
• 检查LangCode变量是否获取到纯文本值
• 排查模板匹配优先级是否存在冲突

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