为何XSLT转换未应用于目标XML文件？

问题场景 #

处理以下XML文件：

<?xml version="1.0" encoding="UTF-8"?>
<catalog>
  <group name="group1">
    <control name="control1.1">
      <p>Content1</p>
    </control>
    <control name="control1.2">
      <prop name="required" value="true"/>
      <p>Content2</p>
    </control>
  </group>
  <group name="group2">
    <control name="control2.1">
      <prop name="required" value="true"/>
      <p>Content1</p>
    </control>
    <control name="control2.2">
      <p>Content2</p>
    </control>
  </group>
</catalog>

应用以下XSLT，预期仅保留带有required属性的control节点（control1.2和control2.1），同时保留原XML结构：

<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

  <xsl:template match="/ | @* | node()">
    <xsl:copy>
      <xsl:apply-templates select="@* | node()"/>
    </xsl:copy>
  </xsl:template>

  <xsl:template match="control">
    <xsl:if test="prop[@name='required']">
      <xsl:copy>
        <xsl:apply-templates select="@* | node()"/>
      </xsl:copy>
    </xsl:if>
  </xsl:template>

</xsl:stylesheet>

但处理后返回完整XML，无任何转换效果。尝试测试<xsl:template match="control"/>（本应移除所有control节点）也无作用，怀疑全局标识转换忽略了control模板。

问题分析与解决 #

核心原因 #

你的XSLT逻辑本身没有问题，大概率是XSLT处理器未正确加载自定义模板，或者存在调用层面的错误，而非模板优先级问题（同优先级模板按出现顺序匹配，你的control模板在全局模板之后，本应生效）。

分步解决 #

• 检查文件加载与编码
  确认XSLT文件路径正确，没有引用旧版本或错误的文件；同时验证文件编码为utf-8，和声明一致，避免编码解析错误导致模板失效。

• 强制提升模板优先级
  显式给control模板设置priority属性，确保它优先于全局模板被匹配：

  <xsl:template match="control" priority="1">
    <xsl:if test="prop[@name='required']">
      <xsl:copy>
        <xsl:apply-templates select="@* | node()"/>
      </xsl:copy>
    </xsl:if>
  </xsl:template>
  

• 验证模板是否被触发
  在control模板中加入调试输出，确认处理器是否识别到该模板：

  <xsl:template match="control">
    <xsl:message>已匹配control节点：<xsl:value-of select="@name"/></xsl:message>
    <xsl:if test="prop[@name='required']">
      <xsl:copy>
        <xsl:apply-templates select="@* | node()"/>
      </xsl:copy>
    </xsl:if>
  </xsl:template>
  

  如果看不到xsl:message的输出，说明模板未被加载，重点检查处理器调用逻辑（比如工具是否未触发转换、代码中转换逻辑有误）。

• 极简测试确认处理器正常
  使用极简XSLT测试处理器是否工作：

  <?xml version="1.0" encoding="utf-8"?>
  <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:template match="/ | @* | node()">
      <xsl:copy>
        <xsl:apply-templates select="@* | node()"/>
      </xsl:copy>
    </xsl:template>
    <xsl:template match="control"/>
  </xsl:stylesheet>
  

  若此测试仍无法删除所有control节点，说明问题出在处理器调用环节，而非XSLT代码本身。

预期输出 #

问题解决后，转换后的XML应为：

<?xml version="1.0" encoding="UTF-8"?>
<catalog>
  <group name="group1">
    <control name="control1.2">
      <prop name="required" value="true"/>
      <p>Content2</p>
    </control>
  </group>
  <group name="group2">
    <control name="control2.1">
      <prop name="required" value="true"/>
      <p>Content1</p>
    </control>
  </group>
</catalog>

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