RestHighLevelClient 7.17.21写入Elasticsearch 8请求异常问题

问题原因 #

7.17.x版本的Elasticsearch RestHighLevelClient在启用setApiCompatibilityMode(true)时，对带有显式文档类型的IndexRequest（即双参数构造new IndexRequest(index, type)）的路径构造逻辑存在兼容性bug，导致请求路径被错误解析为根路径/，最终触发不符合预期的GET请求并返回404。

另外，ES8已彻底废弃文档类型（仅保留_doc作为默认占位符），7.17版本客户端对类型参数的处理逻辑较7.0.x有较大调整，显式传递类型参数会触发内部路径构造异常。

解决方案 #

方案1：修改IndexRequest构造方式，移除显式类型参数 #

ES8及7.x后期版本推荐使用单参数构造IndexRequest，默认文档类型即为_doc，无需显式指定：

// 替换原双参数构造
IndexRequest request = new IndexRequest("MyIndex");
// 若需兼容旧逻辑，可显式设置类型（可选，ES8会自动忽略）
request.type("_doc");

request.source("{\"module\": \"vol1\",\"time\": \"2024-06-07T00:00:00-0400\",\"message\": \"Test\",\"znodename\": \"N/A\"}", XContentType.JSON);
IndexResponse _ir = client.index(request, RequestOptions.DEFAULT);

方案2：关闭API兼容模式（若ES8环境已完全适配） #

如果应用已完全适配ES8的API规范，可移除setApiCompatibilityMode(true)配置，直接构建客户端：

client = new RestHighLevelClientBuilder(clientBuilder.build()).build();

该模式主要用于让7.x客户端兼容ES6的API，对接ES8时反而可能引发兼容性问题。

方案3：检查并统一依赖版本 #

确认项目中所有Elasticsearch相关依赖（包括SpringBoot自动引入的依赖）版本统一为7.17.21，避免因版本不一致导致的请求构造异常。例如Maven配置：

<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level-client</artifactId>
    <version>7.17.21</version>
</dependency>
<dependency>
    <groupId>org.elasticsearch</groupId>
    <artifactId>elasticsearch</artifactId>
    <version>7.17.21</version>
</dependency>

验证建议 #

修改后重新测试写入逻辑，通过日志或抓包确认请求路径为POST /MyIndex/_doc，而非根路径，即可确认问题解决。

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