Spring Boot集成Elasticsearch：兼容依赖、仓库与配置问询

针对你遇到的RestHighLevelClient过时、使用ElasticsearchRepository时出现“Unable to parse response body”的问题，以下是官方兼容的依赖、操作方式及配置方案：

一、兼容版本依赖（POM） #

Spring Boot 2.7.3 对应 Spring Data Elasticsearch 4.4.x，适配 Elasticsearch 7.17.x 系列（官方稳定兼容组合）。直接引入starter即可，Spring Boot依赖管理会自动处理版本匹配：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
    <version>2.7.3</version>
</dependency>

若需直接使用Elasticsearch官方新客户端ElasticsearchClient，可显式引入（starter已间接包含，此为可选）：

<dependency>
    <groupId>co.elastic.clients</groupId>
    <artifactId>elasticsearch-java</artifactId>
    <version>7.17.9</version>
</dependency>

二、推荐的操作方式 #

1. ElasticsearchRepository：无需替换，只要实体映射正确，依然可以正常使用，报错并非仓库本身问题。
2. ElasticsearchOperations：注入ElasticsearchOperations（或实现类ElasticsearchRestTemplate），支持更复杂的CRUD和查询操作，已适配新客户端，无过时问题。
3. 官方ElasticsearchClient：Elasticsearch官方推荐的新客户端，完全替代过时的RestHighLevelClient，适合需要底层操作的场景。

三、正确配置方式 #

方式1：Spring Boot自动配置（推荐） #

无需手动编写配置类，在application.yml中配置ES连接信息即可：

spring:
  elasticsearch:
    uris: http://localhost:9200
    # 有认证需求时添加
    username: elastic
    password: your-password

Spring Boot会自动创建RestHighLevelClient（虽标注过时但仍可用）、ElasticsearchRestTemplate和ElasticsearchClient实例，直接注入使用即可。

方式2：手动配置官方ElasticsearchClient #

若要完全抛弃过时客户端，手动配置新客户端实例：

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.json.jackson.JacksonJsonpMapper;
import co.elastic.clients.transport.rest_client.RestClientTransport;
import org.apache.http.HttpHost;
import org.elasticsearch.client.RestClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class ElasticsearchConfig {

    @Bean
    public ElasticsearchClient elasticsearchClient() {
        RestClient restClient = RestClient.builder(
                new HttpHost("localhost", 9200, "http")
                // 多节点可继续添加
                // new HttpHost("localhost", 9201, "http")
        ).build();

        // 复用Spring Boot的Jackson JSON处理器
        RestClientTransport transport = new RestClientTransport(
                restClient, new JacksonJsonpMapper());

        return new ElasticsearchClient(transport);
    }
}

四、解决“Unable to parse response body”错误 #

数据成功入库但报错，说明ES响应无法映射到实体类，常见原因及修复：

• 字段类型不匹配：检查实体类@Field注解的类型是否与ES索引mapping一致，比如日期字段需指定格式：

  @Document(indexName = "your_index")
  public class YourEntity {
      @Id
      private String id;
  
      @Field(type = FieldType.Date, pattern = "yyyy-MM-dd HH:mm:ss")
      private Date createTime;
      // getter/setter
  }
  

• 缺少必要注解：确保实体类添加@Document指定索引名，主键字段添加@Id，非默认类型字段添加@Field定义类型。
• 索引结构不匹配：若手动创建索引，检查mapping是否与实体字段对应；若自动创建索引，确保spring.data.elasticsearch.repositories.enabled=true（默认开启）。
• 未映射元数据：ES响应包含_score、_type等元数据，若实体类无对应字段，可通过查询时指定返回字段避免解析错误。

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