使用Xspec测试XSLT 3.0样式表时所有测试均失败的排查请求

以下是几个核心排查方向，大概率是配置或匹配逻辑的问题，和Xspec框架本身关系不大：

• 模板调用的上下文/参数匹配问题
  确认Xspec中调用模板的语法是否准确：

  • 如果目标模板是<xsl:match>类型而非命名模板，需要用<x:apply-templates>而非<x:call-template>，同时通过<x:context>指定正确的匹配上下文节点；
  • 如果模板依赖参数，检查<x:call-template>里的<x:with-param>是否传递了正确的参数名、参数值，注意参数名大小写要和XSLT模板里完全一致。

• XML命名空间不匹配
  这是最容易忽略的坑：若XSLT输出的XML带有命名空间，而预期结果未声明对应命名空间或前缀，Xspec的深度匹配会直接判定不相等。比如模板输出：

  <ns:result xmlns:ns="http://example.com/test">success</ns:result>
  

  但预期结果只写：

  <result>success</result>
  

  就会匹配失败。解决办法是在预期结果里正确声明命名空间，或者用<x:expect>的select属性通过XPath匹配（忽略前缀，匹配本地名和值）。

• 空白节点干扰匹配
  XSLT默认保留空白节点（比如模板里的换行、缩进），而你写的预期结果若为紧凑XML，Xspec会判定节点不匹配。可以：

  • 在XSLT的<xsl:stylesheet>中添加<xsl:strip-space elements="*"/>去除多余空白；
  • 在Xspec的<x:expect>里添加ignore-whitespace="true"属性，忽略空白差异。

• run-as属性的场景适配

  • run-as="import"：将测试样式表导入主样式表，适合依赖主样式表全局变量、自定义函数、其他模板的测试场景；
  • run-as="external"：独立调用目标模板，仅适用于完全无依赖的独立模板测试，若模板依赖主样式表上下文，会因找不到依赖输出异常；
    需根据模板的依赖关系选择对应值，而非盲目切换。

• 对比实际输出与预期结果
  在Xspec测试场景中添加<x:output/>标签，执行测试后查看实际生成的XML输出，和预期结果逐节点对比，能快速定位差异——比如节点名称错误、属性缺失、值不匹配、命名空间遗漏等。

• 版本兼容性检查
  确认Xspec版本与Saxon版本兼容：Xspec 2.x支持Saxon 9.8到12.x，若使用过旧的Xspec版本（如1.x）搭配Saxon 11，可能出现兼容性问题，建议升级到最新稳定版Xspec。

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