OpenSearch 2.11.1混合搜索子查询过滤器语法报错求助

错误原因 #

你碰到的Index 1 out of bounds for length 1错误，本质是OpenSearch 2.11.1版本中，混合搜索的neural子查询无法兼容嵌套在带filter的bool查询中。neural向量检索的执行逻辑和常规全文查询不同，这种嵌套结构会触发内部数组越界的bug。

从你测试的结果也能印证这点：无过滤器、仅给全文检索子查询加过滤器都正常，唯独给neural子查询加filter就报错。

正确实现方式 #

不需要给每个混合搜索子查询单独加filter，而是把过滤逻辑提到外层，用bool查询统一包裹hybrid查询，这样既满足过滤需求，又规避了版本兼容性问题：

{
    "query": {
        "bool": {
            "filter": [
                {
                    "term": {
                        "content_type": "text"
                    }
                }
            ],
            "must": [
                {
                    "hybrid": {
                        "queries": [
                            {
                                "multi_match": {
                                    "query": "solar",
                                    "type": "most_fields",
                                    "fields": [
                                        "og_title^3",
                                        "og_description^2",
                                        "name^2",
                                        "href_filename^2",
                                        "content"
                                    ]
                                }
                            },
                            {
                                "neural": {
                                    "embedding": {
                                        "query_text": "solar",
                                        "model_id": "LTZ1F40B3USp5Eb6uqGR",
                                        "k": 5
                                    }
                                }
                            }
                        ]
                    }
                }
            ]
        }
    },
    "size": 10,
    "_source": {
        "excludes": [
            "embedding"
        ]
    }
}

额外说明 #

• 这个写法的逻辑是先过滤出content_type: text的文档，再对这些文档执行混合搜索，和你原本的需求完全一致，但更符合OpenSearch 2.11.1的查询规范。
• 若你需要给不同子查询设置差异化过滤（而非全局统一过滤），可以尝试使用neural查询内置的filter参数（部分版本支持），但2.11.1中该参数稳定性不足，优先推荐外层统一过滤的方案。

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