Elasticsearch 8.5.2 bool查询must字段解析失败报错求助

问题原因 #

在Elasticsearch 8.x（含8.5.2）版本中，knn是特殊的向量查询类型，不能直接嵌套在bool查询的must/should/must_not子句中，仅允许作为顶层查询，或放在bool的filter子句内。你的查询将knn置于bool.must数组中，触发了解析错误。

修正方案 #

方案1：仅需knn检索时（直接作为顶层查询） #

如果只需要向量相似性检索，直接把knn设为query的顶层属性：

query = {
    "size": 50,
    "_source": "Title",
    "query": {
        "knn": {
            "vectors": {
                "vector": token_vector,
                "k": 20
            }
        }
    }
}

res = es.search(index='posting', body=query)

方案2：结合其他查询条件（用bool.filter承载knn） #

如果需要同时添加文本匹配、关键词过滤等其他条件，将knn放在bool.filter中，其他查询逻辑放在must里：

query = {
    "size": 50,
    "_source": "Title",
    "query": {
        "bool": {
            "must": [
                # 这里添加常规查询，比如match、term等
                {"match": {"Content": "elasticsearch"}}
            ],
            "filter": [
                {
                    "knn": {
                        "vectors": {
                            "vector": token_vector,
                            "k": 20
                        }
                    }
                }
            ]
        }
    }
}

res = es.search(index='posting', body=query)

额外注意点 #

• 确认vectors字段已正确映射为dense_vector类型，且维度与token_vector完全一致；
• 若升级到Elasticsearch 8.6及以上版本，已支持将knn直接嵌套在bool的must/should子句中，升级版本也可解决此问题。

内容的提问来源于stack exchange，提问作者Sanjeeva Kumar Kanakam