使用Saxon S9API Java处理XML，遇Schematron规则遮蔽警告如何解决？

我尝试使用Schematron验证XML文件，从XdmNode中收到如下警告：<!--WARNING: Rule for context "test:responseTest" shadowed by preceding rule-->。该警告出现在遍历根节点下的所有XdmNode时，我的Java代码如下：

for (XdmNode node : rootnode.children().iterator().next().children()) {
     if(node.getNodeKind() == XdmNodeKind.COMMENT) {
        continue;
    }
 }

请问这是Schematron的问题吗？该如何修复此警告？

问题本质 #

这不是Schematron本身的问题，是你定义的Schematron规则存在冲突：

• 你创建了多个上下文为test:responseTest的<rule>标签
• Schematron处理器执行规则时，会优先使用第一个匹配上下文的规则，后续同上下文的规则会被忽略，因此抛出“规则被遮蔽”的警告

具体修复方案 #

1. 合并同上下文的规则 #

把所有针对test:responseTest的校验逻辑整合到同一个<rule>中，这是最规范的做法：

<!-- 错误示例：重复上下文规则 -->
<rule context="test:responseTest">
  <assert test="@code">响应必须包含code属性</assert>
</rule>
<rule context="test:responseTest">
  <assert test="test:result">响应必须包含result子节点</assert>
</rule>

<!-- 正确示例：合并到单个规则 -->
<rule context="test:responseTest">
  <assert test="@code">响应必须包含code属性</assert>
  <assert test="test:result">响应必须包含result子节点</assert>
</rule>

2. 给规则设置差异化上下文 #

如果确实需要拆分规则，要为每个规则定义不同的上下文条件，比如通过节点属性、子节点区分：

<rule context="test:responseTest[@type='success']">
  <assert test="test:successMsg">成功响应必须包含提示信息</assert>
</rule>
<rule context="test:responseTest[@type='error']">
  <assert test="test:errorCode">错误响应必须包含错误码</assert>
</rule>

3. 调整规则顺序（不推荐） #

如果因特殊需求必须保留同上下文的多个规则，把优先级高的规则放在前面，但这种做法仍会触发警告，且容易导致逻辑混乱，不建议使用。

关于Java代码的说明 #

你的Java代码只是遍历节点并跳过注释，和警告的产生没有直接关联——警告是Schematron验证过程中生成的，不是遍历XdmNode导致的。代码逻辑本身没问题，若要处理这类警告，应该在配置Schematron处理器时添加日志监听，而不是靠遍历节点过滤。

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