Rest API扩展PUT文档时cts:search性能远低于GET请求的问题求助

核心原因 #

PUT属于REST API的写入类请求，默认会启动更新事务，即使你在xdmp:eval中设置<update>false</update>，外层的更新事务上下文依然会影响内部查询——比如查询需要等待锁、事务隔离级别导致的索引快照不一致，或者查询路径走了更新事务的特殊逻辑，这些都会拖慢cts:search的速度。单纯的eval选项无法覆盖外层事务的模式。

可行解决方法 #

1. 用xdmp:invoke调用独立只读模块 #

把cts:search的逻辑封装到一个单独的只读XQuery模块中，然后在PUT扩展里用xdmp:invoke调用，明确指定只读事务模式：

<!-- PUT扩展中的调用代码 -->
xdmp:invoke(
  "/modules/readonly-search.xqy", 
  (), 
  <options xmlns="xdmp:invoke">
    <update>false</update>
    <transaction-mode>query-only</transaction-mode>
  </options>
)

<!-- /modules/readonly-search.xqy 内容 -->
cts:search(
  fn:doc(), 
  cts:word-query("your-search-term"), 
  <options xmlns="cts:search">
    <!-- 与GET请求中完全一致的查询选项 -->
  </options>
)

这种方式会让查询在独立的只读事务中执行，完全脱离外层PUT的更新事务上下文，消除锁竞争和事务模式带来的性能损耗。

2. 用xdmp:eval指定transaction-mode="query-only" #

如果不想拆分模块，可以直接在xdmp:eval中明确设置事务模式为query-only，这个选项比单纯的<update>false</update>优先级更高，能强制开启只读查询事务：

xdmp:eval(
  "cts:search(fn:doc(), cts:word-query('your-search-term'), $options)",
  (xs:QName("options"), $your-search-options),
  <options xmlns="xdmp:eval">
    <transaction-mode>query-only</transaction-mode>
    <update>false</update>
  </options>
)

3. 排查锁竞争问题 #

如果上述方法无效，检查PUT操作是否在更新大量文档或持有长时间锁：

• 避免在PUT扩展中一次性更新过多文档，拆分批量操作
• 检查cts:search的查询范围是否包含正在被PUT更新的文档集，尝试缩小查询范围或调整锁级别

4. 验证查询一致性 #

先确认GET和PUT中的cts:search使用完全相同的查询选项（比如排序、过滤、聚合、索引使用策略），排除因查询逻辑差异导致的性能差距。

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