如何在Elasticsearch Java客户端的knnQuery中设置k值？

可能的原因及解决方案 #

1. 客户端版本不匹配 #

KNN查询在Elasticsearch 8.x版本才正式成为GA功能，旧版本（如7.x）中KNN是实验性特性，API定义不同，且不存在k()方法。

• 确认Maven依赖版本：替换为8.x及以上版本的Elasticsearch Java客户端依赖：

<dependency>
    <groupId>co.elastic.clients</groupId>
    <artifactId>elasticsearch-java</artifactId>
    <version>8.13.0</version> <!-- 使用最新稳定版 -->
</dependency>

2. 代码写法修正 #

若已使用8.x版本客户端，检查代码是否符合当前API规范，正确的KNN查询构建写法如下：

Query knnQuery = QueryBuilders.knn(knn -> knn
    .field("denseEmbeddings")
    .queryVector(textDenseVector)
    .k(5)
);

3. 排除旧依赖冲突 #

若项目中同时存在旧版Elasticsearch客户端依赖（如elasticsearch-rest-high-level-client），会导致类加载冲突，需移除旧依赖，仅保留elasticsearch-java依赖。

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