使用Saxon PE-11.4 XSLT3.0时无匹配项出现奇怪类型错误

问题背景 #

在Saxon PE-11.4（XSLT 3.0）环境下，千行级XSLT代码出现类型错误：变量$mediaElement声明为element(Q{}Media)类型，但实际传入了文本节点。问题触发点是定义该变量时调用了makeMedia模式的apply-templates，原本预期无匹配模板时返回空的Media元素序列，结果因为XSLT默认规则的作用生成了文本节点。目前已通过添加<xsl:template mode="makeMedia" match="text()"/>解决问题，但存在三个疑问待解答。

疑问解答 #

a) 简化显式匹配文本节点的方法 #

不用给每个模式都单独写空的text()模板，可以定义一个全局通用的空模板，匹配所有模式下的文本节点：

<xsl:template match="text()" mode="#all"/>

这个模板会覆盖所有模式的文本节点默认处理规则，避免重复编写同类型模板，一次性解决所有模式下的文本节点意外输出问题。

b) <xsl:strip-space elements="*"/>的实际影响 #

这个指令的核心作用是移除所有元素节点下的纯空白文本节点（即完全由空格、换行、制表符组成的节点），非空白内容的文本节点不受影响。

• 适用场景：如果你的XML源文档中大量空白只是格式化缩进，没有实际语义，用它能减少冗余文本节点，从根源上避免默认规则触发的类型错误。
• 风险点：如果某些元素内的空白是内容的一部分（比如段落换行、代码缩进），使用该指令会直接丢失这些空白，导致输出内容格式或语义异常。

c) 需要保留空格的典型场景 #

以下场景必须保留空格，不能随意移除或忽略文本节点：

• 纯文本内容区域：比如文章段落、用户留言，空白是排版格式的必要部分，直接影响可读性。
• 代码或配置片段：缩进、换行等空白是代码结构的一部分，丢失会导致代码无法正常解析或可读性极差。
• 语义依赖空白的元素：比如用空格分隔的枚举值列表（<tags>foo bar baz</tags>），空白是值之间的分隔符，移除后会破坏语义。
  这类场景下，建议针对性处理——比如仅在特定模式下忽略无关的空白文本，或者使用normalize-space()按需清理多余空白而非全盘移除。

内容的提问来源于stack exchange，提问作者MrD at KookerellaLtd