Elasticsearch嵌套dense_vector余弦相似度查询报Required [query]错误如何解决

算力阿峰

2026-9-28

排查解决思路

直接报错原因

script_score 查询语法要求必须包含一个基础query子句，你当前的写法缺失了该必填参数，这是触发Required [query]错误的核心原因。

其他隐藏问题

字段名不匹配：你的mapping中dense_vector字段名为doc_vector，但查询脚本中写的是vector，字段对应错误会导致后续查询即使修复语法也取不到值。
nested上下文字段访问格式错误：nested查询内不能直接通过document_vectors.xxx的方式访问字段，需要使用doc['<字段全路径>']的格式取值。
相似度分数兼容问题：cosineSimilarity的返回值范围为[-1,1]，最好做偏移处理避免负分影响排序逻辑。

修正后的查询语句

{
    "size": results_size,
    "query": {
        "nested": {
            "path": "document_vectors",
            "score_mode": "max",
            "query": {
                "script_score": {
                    "query": {
                        "match_all": {}
                    },
                    "script": {
                        "source": "doc['document_vectors.doc_vector'].size() == 0 ? 0 : cosineSimilarity(params.query_vector, 'document_vectors.doc_vector') + 1.0",
                        "params": {"query_vector": query_vector}
                    }
                }
            }
        }
    }
}