XSLT调用外部模板加载XML文件无输出问题排查

问题背景 #

现有主XML文件需转换为HTML，同时处理嵌套子节点（class分为image和section两类）。使用XSLT的document()函数加载子节点对应的外部XML，但转换后无内容输出，仅能确认模板已被调用（输出子节点@id正常）。

主XML示例 #

<?xml version='1.0' encoding='utf-8'?>
<document id="random_id_doc" class="doc">
  <properties>
    <randomProperty name="name"><![CDATA[Name]]></randomProperty>
  </properties>
  <children>
    <child id="random_id1" path="C:\random_id1.xml" class="image"/>
    <child id="random_id2" path="C:\random_id2.xml" class="section"/>
  </children>
</document>

子节点XML示例（section类型） #

<?xml version="1.0" encoding="UTF-8"?>
<object id="empty-section" class="section">
  <properties>
    <randomProperty name="name"><![CDATA[Name]]></randomProperty>
  </properties>
  <children>
    <child id="random_id3" path="C:\random_id3.xml" class="image"/>
  </children>
  <traces />
</object>

核心代码片段 #

主XSLT核心逻辑及section.xslt代码见用户提供内容。

排查与解决方案 #

1. 模板调用不匹配 #

section.xslt中的模板定义了mode="call-template"，但主XSLT调用时未指定对应mode，导致模板无法执行。直接移除mode属性即可：

<xsl:template name="section">
  <xsl:variable name="path" select="@path"/>
  <xsl:value-of select="document($path)/object/@id" disable-output-escaping="yes"/>
</xsl:template>

2. 本地路径转义问题 #

Windows路径的反斜杠\在XSLT中是转义字符，会导致路径解析错误。有两种解决方式：

• 修改源XML中的路径，将\改为双反斜杠\\或正斜杠/，例如：path="C:\\random_id2.xml"
• 若无法修改源XML，在XSLT中动态处理路径：

<xsl:template name="section">
  <xsl:variable name="raw-path" select="@path"/>
  <!-- 将反斜杠替换为正斜杠 -->
  <xsl:variable name="path" select="translate($raw-path, '\', '/')"/>
  <xsl:value-of select="document($path)/object/@id"/>
</xsl:template>

3. 处理器文件访问权限限制 #

部分XSLT处理器（如浏览器环境、沙箱工具）会限制本地文件访问，导致document()无法加载外部XML：

• 改用桌面/服务器端处理器（如Saxon、Xalan），这类工具默认允许本地文件访问
• 若在浏览器中运行，需将所有文件部署到HTTP服务器，使用相对路径或HTTP URL

4. 嵌套子节点逻辑错误 #

当前child模板中，select="children/child"是基于主XML的<child>节点查找，但该节点本身没有<children>子节点——<children>存在于外部XML的<object>节点中。修改逻辑如下：

<xsl:template name="child">
  <!-- 加载外部XML的object节点 -->
  <xsl:variable name="path" select="@path"/>
  <xsl:variable name="object-node" select="document($path)/object"/>
  
  <!-- 调用对应模板处理object -->
  <xsl:apply-templates select="$object-node"/>
  
  <!-- 递归处理外部object中的子节点 -->
  <xsl:for-each select="$object-node/children/child">
    <xsl:call-template name="child"/>
  </xsl:for-each>
</xsl:template>

同时建议将命名模板改为匹配模式，更符合XSLT规范：

<!-- 替换原object命名模板 -->
<xsl:template match="object[@class='section']">
  <xsl:call-template name="section"/>
</xsl:template>
<xsl:template match="object[@class='image']">
  <xsl:call-template name="image"/>
</xsl:template>

5. 调试技巧 #

• 在模板中添加调试输出，确认路径是否正确解析：

<xsl:template name="section">
  <xsl:variable name="path" select="@path"/>
  <div>调试路径：<xsl:value-of select="$path"/></div>
  <xsl:value-of select="document($path)/object/@id"/>
</xsl:template>

• 使用XSLT处理器的调试工具（如Saxon命令行输出、IDE调试功能），查看document()返回的节点集是否为空

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