XSLT3.0处理JSON转XML时数组模板未调用的问题问询

1. 为何数组模板未触发？结合XSLT 3.0优先级规则解释 #

首先明确json-to-xml()的输出结构：JSON数组会被转换为无命名空间的<array>元素（如果是对象属性值，会带key属性，比如<array key="foo">）。

模板未触发的核心原因结合XSLT 3.0优先级规则分析：
XSLT模板优先级由匹配模式的特异性决定，核心优先级层级从高到低为：

• 带谓词的元素/属性名（优先级0.75，如array[@key]）
• 纯元素/属性名（优先级0.5，如array）
• 通配符*/element()（优先级0.25）
• 通用node()匹配（优先级0.0）

如果数组模板未被调用，大概率是两种情况：

1. 匹配模式不匹配目标节点：比如错误给array添加了命名空间（json-to-xml输出无命名空间），或者匹配路径错误（比如写了/array但实际数组嵌套在<map>下）；
2. 优先级未超过通用模板：比如通用模板用了带谓词的通配符（如*[contains(local-name(), 'arr')]，优先级0.75），而你的数组模板是纯元素名匹配（优先级0.5），此时通用模板优先级更高会被选中；或者你使用了模板模式（mode），但数组模板未指定对应mode，导致通用模板（无mode或同mode）被调用。

2. 如何让这些模板自动被调用？ #

按以下步骤排查调整：

• 确保匹配模式准确：直接用match="array"匹配json-to-xml输出的数组节点，若需匹配带特定属性的数组，用match="array[@key='xxx']"；
• 正确应用模板到数组节点：处理<map>节点时，使用<xsl:apply-templates select="*"/>而非跳过数组节点（比如不要写select="*/*"直接处理数组内元素）；
• 对齐模板模式：如果你的xsl:apply-templates指定了mode，数组模板必须添加相同mode属性（如<xsl:template match="array" mode="process-json"/>）；
• 提升数组模板优先级：若通用模板优先级更高，给数组模板的匹配模式添加谓词（如match="array[true()]"），将优先级从0.5提升到0.75，超过通用通配符模板；
• 调整通用模板范围：把通用模板的匹配模式从*改为node()（优先级0.0），确保数组模板（0.5）优先级更高。

示例正确模板结构：

<!-- 通用模板 -->
<xsl:template match="node()">
  <xsl:apply-templates/>
</xsl:template>

<!-- 数组模板（优先级0.5，高于通用node()模板） -->
<xsl:template match="array">
  <custom-list>
    <xsl:apply-templates select="*"/>
  </custom-list>
</xsl:template>

3. 若无法实现自动调用，最优模块化解决方案？ #

如果因现有模板结构复杂无法调整优先级或自动匹配，推荐以下模块化方案（按优先级排序）：

1. 使用模板模式（Mode）分离逻辑：为数组处理单独定义专属模式，避免和通用模板冲突：

   <xsl:template match="array" mode="process-array">
     <!-- 数组处理逻辑 -->
   </xsl:template>
   
   <!-- 调用处 -->
   <xsl:apply-templates select="array" mode="process-array"/>
   

   这种方式最符合XSLT声明式风格，逻辑隔离清晰。

2. 封装为命名模板：将数组处理逻辑封装为命名模板，通过参数传递数组节点：

   <xsl:template name="process-array">
     <xsl:param name="array-node" as="element(array)"/>
     <!-- 处理$array-node的逻辑 -->
   </xsl:template>
   
   <!-- 调用处 -->
   <xsl:call-template name="process-array">
     <xsl:with-param name="array-node" select="array"/>
   </xsl:call-template>
   

   适合需要复杂参数控制的场景。

3. 封装为XSLT 3.0函数：将数组处理逻辑转为可复用函数，支持在任何表达式中调用：

   <xsl:function name="my:process-array" as="node()*">
     <xsl:param name="array-node" as="element(array)"/>
     <!-- 返回处理后的节点 -->
     <custom-list>
       <xsl:apply-templates select="$array-node/*"/>
     </custom-list>
   </xsl:function>
   
   <!-- 调用处 -->
   <xsl:sequence select="my:process-array(array)"/>
   

   适合高度模块化、需要嵌入表达式的场景。

4. 参考方案中的<xsl:copy>元素是否有特定用途，还是多余？ #

<xsl:copy>的用途取决于你的需求：

• 必要场景：如果需要保留json-to-xml输出的<array>节点的原始属性（比如key属性，对应JSON中的数组属性名）和节点名称，<xsl:copy>是必须的——它会复制当前节点的节点名、命名空间和属性，但不复制子节点，之后你可以在<xsl:copy>内部处理子元素：

  <xsl:template match="array">
    <xsl:copy> <!-- 保留原<array key="foo">节点结构 -->
      <xsl:apply-templates select="*"/> <!-- 处理数组内的元素 -->
    </xsl:copy>
  </xsl:template>
  

• 多余场景：如果你的需求是完全重构XML结构，不需要保留原<array>的任何上下文信息（比如直接输出<custom-list>代替<array>），此时<xsl:copy>就是多余的，可以直接输出自定义元素。

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