MarkLogic结构化容器查询通过Search API执行结果错误，Query Console正常

问题场景 #

使用MarkLogic的Structured Query，通过container-query限定在citations元素内搜索术语，在MarkLogic Query Console中执行可正确返回仅术语位于指定元素内的文档，但通过MarkLogic Search API端点提交相同XML查询时，却返回术语出现在文档任意位置的结果。

结构化查询XML #

<query xmlns="http://marklogic.com/appservices/search" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:search="http://marklogic.com/appservices/search" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <search:and-query>
        <search:and-query>
            <search:container-query>
                <search:element ns="" name="citations"></search:element>
                <search:term-query>
                    <search:text>Abdallah</search:text>
                    <search:weight>0.0</search:weight>
                </search:term-query>
            </search:container-query>
        </search:and-query>
        <search:collection-query>
            <search:uri>bmv</search:uri>
        </search:collection-query>
    </search:and-query>
</query>

Query Console中执行的XQuery代码 #

xquery version "1.0-ml";

import module namespace search = "http://marklogic.com/appservices/search" at "/MarkLogic/appservices/search/search.xqy";

let $query :=
<query xmlns="http://marklogic.com/appservices/search" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:search="http://marklogic.com/appservices/search" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <search:and-query>
        <search:and-query>
            <search:container-query>
                <search:element ns="" name="citations"></search:element>
                <search:term-query>
                    <search:text>Abdallah</search:text>
                    <search:weight>0.0</search:weight>
                </search:term-query>
            </search:container-query>
        </search:and-query>
        <search:collection-query>
            <search:uri>bmv</search:uri>
        </search:collection-query>
    </search:and-query>
</query>

let $options :=
    <options xmlns="xdmp:eval">
      <user-id>{xdmp:user("patent_poc-writer")}</user-id>
    </options>

return xdmp:invoke-function(function(){search:resolve($query)}, $options)

解决步骤 #

• 检查API请求参数传递方式：确保结构化查询通过正确的参数提交。Search API中，结构化查询应使用query参数（GET方式）或放在POST请求的body中，而非q参数（q参数用于字符串查询语法，会忽略结构化查询的容器限定）。同时设置正确的Content-Type为application/xml，避免XML解析错误。
• 统一查询选项配置：Query Console中执行search:resolve时未指定自定义options，使用的是默认配置。在API请求中显式传递与之一致的空options，避免API使用的默认选项干扰查询逻辑：

  <options xmlns="http://marklogic.com/appservices/search"/>
  

• 验证XML命名空间完整性：确认提交的XML查询中search前缀对应的命名空间http://marklogic.com/appservices/search未被HTTP客户端篡改，命名空间错误会导致MarkLogic无法正确解析container-query节点。
• 对齐用户权限上下文：检查Search API请求使用的用户是否与Query Console中执行的patent_poc-writer用户一致，权限差异可能导致文档可见性不同，或查询执行上下文不一致。

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