Apache NiFi调用MarkLogic查询处理器触发XDMP-RWINVAL0异常

先直接拆解这个报错的核心：XDMP-RWINVAL0: The value of expression '$0' is required to be non-zero in rule: set-transaction-timestamp 这个错误明确指向事务时间戳参数无效（为0），而你的查询在MarkLogic控制台能正常执行，说明查询本身没问题，问题出在NiFi处理器的事务配置或者客户端与服务器的交互逻辑上。

下面是具体的排查步骤和解决方法：

可能的原因 #

• NiFi处理器的事务时间戳配置错误：QueryMarkLogic处理器如果被手动设置了Transaction Timestamp为0或者无效值，MarkLogic服务器会拒绝这个请求——因为事务时间戳要求必须是非零的有效Unix时间戳。
• MarkLogic客户端与服务器版本不兼容：NiFi集成的MarkLogic Data Movement SDK版本和你的MarkLogic服务器版本不匹配，导致API调用时参数传递格式出现问题。
• 一致性点配置不当：如果处理器配置了错误的Consistent Point（比如无效的时间点），也会触发这个事务时间戳相关的错误。

解决方法 #

1. 检查并修正事务时间戳配置 #

• 打开NiFi中QueryMarkLogic处理器的配置面板，找到Transaction Timestamp（或类似名称的配置项）：
  • 如果这个属性被手动设置为0或者空值（部分场景下空值会被解析为0），请修改为一个有效的Unix时间戳（比如对应你数据存在的时间范围，比如1526632530对应2018-05-18，和你报错的时间接近）。
  • 如果你不需要指定特定的历史事务时间，直接清空这个属性，让处理器自动使用当前的事务时间，这是最安全的默认配置。

2. 验证客户端与服务器版本兼容性 #

• 确认NiFi使用的MarkLogic客户端SDK版本和你的MarkLogic服务器版本保持一致：
  • 比如如果你的服务器是9.0.x版本，NiFi的MarkLogic处理器也应该使用9.0.x对应的客户端JAR包。版本不匹配可能会导致API调用时参数格式不兼容，进而触发这类参数校验错误。

3. 调整一致性点配置（如果适用） #

• 如果你配置了Consistent Point属性，确保它的值是有效的（比如合法的时间戳或者MarkLogic支持的一致性点标识）。如果不需要强一致性读取，也可以将这个属性留空，让处理器使用默认的读取模式。

4. 测试验证 #

• 修改配置后，重启处理器并重新运行任务，观察是否还会触发相同的异常。
• 可以用MarkLogic Data Movement SDK写一个简单的测试代码（模拟NiFi处理器的逻辑），执行同样的cts:and-query查询，验证是否能正常获取文档，以此排除NiFi处理器本身的潜在问题。

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