多节点MarkLogic集群中Schematron验证跨节点报错问题求助

问题背景 #

三节点MarkLogic集群中，通过CORB程序执行Schematron验证时，仅某一节点可成功运行，切换至其他节点则报错。报错源自Schematron中针对date类型字段release-date的substring(., 1, 4)语句，已确认集群ML版本、JAVA版本一致，清理缓存后问题仍存在，Schematron文件存储于模块数据库。

报错的Schematron规则 #

<rule context="standard//release-date"> 
    <let name="rel-y" value="substring(., 1, 4)"/>
    <let name="now-y" value="year-from-date(xs:date(current-date()))"/>
    <!--For SA or SA/SNZ, If release-date [@date-type="published" @std-type="edition"] is not blank then release-version should be '07. Published'-->            
    <report test="not(.[@date-type='published' and @std-type='edition']='') and (../std-org/std-org-abbrev='SA' or ../std-org/std-org-abbrev='SA/SNZ') and not(../release-version='07. Published')" role="error">
        [ERROR][XPATH]<value-of select="fct:generateXPath(self::node())"/>[/XPATH][rel-date_002]  When there is a publication date in release-version date-type='published', then release-version must be 07. Published, for SA's publications [/ERROR]
    </report>
    <!--release-date, Year value should not be later than current year-->
    <report test="number($rel-y) &gt; $now-y + 1" role="warning">
        [WARNING][XPATH]<value-of select="fct:generateXPath(self::node())"/>[/XPATH] [rel-date_003] <name/>:'<value-of select="."/>' is later than next year (value '<value-of select="$now-y"/>') [/WARNING]</report>
</rule>

MarkLogic报错信息 #

错误代码XPTY0004：无法将xs:date类型转换为xs:string类型。原因是substring函数要求输入为字符串，但部分节点上release-date节点为xs:date类型，未自动完成隐式类型转换。

相关ML代码 #

declare function local:validate-schematron($doc)
{   
    let $extractSchematronQuery := 
      "xquery version '1.0-ml';
      let $schematronData := fn:doc('/modules/schematron/NISO-Validation-Schematron.sch')
      return $schematronData"
    let $schematron := xdmp:eval($extractSchematronQuery, (),
                    <options xmlns="xdmp:eval">
                      <database>{xdmp:modules-database()}</database>
                    </options>)
    let $validation := 
        "import module namespace schematron = 'http://marklogic.com/xdmp/schematron' at '/MarkLogic/schematron/schematron.xqy';
        declare variable $doc as node() external; 
        declare variable $schematron as node() external;
        let $xsltSchematron := schematron:compile($schematron/*)
        return
            xdmp:xslt-eval($xsltSchematron, $doc)"
    let $result :=  xdmp:eval($validation, ((xs:QName("doc"), $doc),(xs:QName("schematron"), $schematron)))
    return $result
};

问题成因 #

1. 类型转换行为差异：集群不同节点对xs:date转字符串的隐式转换逻辑不一致，部分节点未触发自动转换，导致substring函数接收非法类型输入。
2. 数据/索引同步延迟：理论上集群数据一致，但可能存在节点间索引同步不及时，或某节点release-date字段实际存储类型与其他节点不一致（如部分为字符串、部分为date类型）。
3. Schematron编译差异：schematron:compile生成的XSLT在不同节点因环境细微差异，导致类型处理逻辑不一致。

解决办法 #

方案1：显式类型转换（推荐） #

修改Schematron规则，要么显式将date类型转为字符串：

<let name="rel-y" value="substring(xs:string(.), 1, 4)"/>

要么直接用date类型函数提取年份，彻底规避字符串操作：

<let name="rel-y" value="year-from-date(.)"/>

后者更可靠，还能兼容不同格式的date数据。

方案2：校验集群数据一致性 #

• 检查所有节点release-date字段的存储类型，确保统一为xs:date或字符串格式。
• 手动触发集群索引同步，确认各节点数据、索引完全一致。

方案3：统一编译执行环境 #

• 修改验证函数，通过xdmp:eval的<host>参数指定固定节点编译Schematron，避免多节点编译差异。
• 提前预编译Schematron为XSLT文件存储到模块数据库，所有节点直接使用预编译文件执行验证。

方案4：统一节点配置 #

• 对比各节点MarkLogic的XQuery/XSLT类型转换相关配置，确保参数一致。
• 重启所有节点，确保缓存清理彻底，配置生效。

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