使用Include的Schematron出现歧义规则匹配错误问题咨询

我之前处理过类似的问题，这个报错的核心原因很明确：同一个XML节点被多个Schematron规则的上下文选择器同时匹配到，而这些规则没有设置明确的优先级，导致Schematron无法确定应该执行哪一个。尤其是在通过<include>引入多个规则文件时，很容易出现不同文件里的规则不小心“撞”到同一个节点的情况。

下面是一步步的解决方法：

• 第一步：定位重复匹配的规则
  先把所有被include的规则文件和主规则文件放在一起，搜索报错信息里的节点路径（比如/filing:FilingMessage/filing:FilingConnectedDocument[1]/ecf:DocumentAugmentation[1]/ecf:DocumentR...），找出所有上下文选择器能匹配到这个节点的规则。你会发现，要么是不同文件里的规则用了相同的上下文选择器，要么是不同的选择器通过不同路径最终定位到了同一个节点。

• 第二步：给规则添加优先级属性
  如果这些规则确实都需要作用于同一个节点（比如不同维度的校验），可以给每个规则加上priority属性，数值越大优先级越高。Schematron会优先执行优先级高的规则，这样就不会再报歧义错误了。
  示例代码：

  <sch:rule context="ecf:DocumentR..." priority="3">
    <!-- 这是最高优先级的规则，会先被执行 -->
    <sch:assert test="@status='valid'">文档状态必须为有效</sch:assert>
  </sch:rule>
  <sch:rule context="ecf:DocumentR..." priority="1">
    <!-- 低优先级规则，高优先级规则执行完后才会处理 -->
    <sch:report test="./text()">文档内容已填写</sch:report>
  </sch:rule>
  

• 第三步：细化规则的上下文选择器
  如果某些规则本不应该匹配这个节点，那就要调整它们的上下文选择器，让匹配范围更精准。比如原来的选择器是ecf:DocumentR，可以加上父节点条件、属性过滤等，避免和其他规则的选择器重叠。
  示例优化：

  <!-- 原来的模糊选择器，容易匹配到多个场景的节点 -->
  <sch:rule context="ecf:DocumentR">...</sch:rule>
  <!-- 修改后的精准选择器，只匹配特定父节点下的目标节点 -->
  <sch:rule context="ecf:DocumentAugmentation[ecf:DocType='Main']/ecf:DocumentR">...</sch:rule>
  

• 第四步：检查是否重复引入了规则文件
  有时候会不小心多次include同一个规则文件，导致同一个规则被加载了两次，自然会出现匹配歧义。打开主Schematron文件，检查所有<sch:include>语句，确保每个规则文件只被引入一次。

• 第五步：合并同上下文的规则
  如果多个规则都是针对同一个节点的不同校验条件，不如把它们合并成一个规则，用多个<sch:assert>或<sch:report>标签分别处理不同的校验逻辑，这样既避免了歧义，也让规则结构更清晰。
  示例合并：

  <sch:rule context="ecf:DocumentR...">
    <sch:assert test="@required='true' and not(./text())">必填的文档内容不能为空</sch:assert>
    <sch:assert test="string-length(./text()) <= 200">文档内容长度不能超过200字符</sch:assert>
    <sch:report test="@lastUpdated">文档已更新至最新版本</sch:report>
  </sch:rule>
  

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