SpringBoot 集成 ElasticSearch（spring-boot-starter-data-elasticsearch）

### Spring Boot 3.3.5 与 spring-boot-starter-data-elasticsearch 兼容的 Elasticsearch 版本 Spring Boot 3.x 系列基于 Spring Framework 6.x，并要求使用 Java 17 或更高版本。在 Spring Boot 3.3.5 中，`spring-boot-starter-data-elasticsearch` 模块默认支持 Elasticsearch 8.x 系列[^1]。这是因为 Spring Data Elasticsearch 在此版本中进行了重大更新，以适配 Elasticsearch 8.x 的新特性，例如移除对 Transport Client 的支持并全面转向 REST High-Level Client。 #### 配置示例 以下是一个配置 `spring-boot-starter-data-elasticsearch` 的示例，展示如何连接到 Elasticsearch 8.x： ```java import org.springframework.context.annotation.Configuration; import org.springframework.data.elasticsearch.client.ClientConfiguration; import org.springframework.data.elasticsearch.client.elc.ElasticsearchConfiguration; import org.springframework.data.elasticsearch.client.elc.RestHighLevelClient; @Configuration public class ElasticsearchConfig extends ElasticsearchConfiguration { @Override public RestHighLevelClient elasticsearchClient() { final ClientConfiguration clientConfiguration = ClientConfiguration.builder() .connectedTo("localhost:9200") .withBasicAuth("elastic", "your-password") // 需要提供用户名和密码 .build(); return RestHighLevelClient.create(clientConfiguration); } } ``` #### 关键点说明 - **Elasticsearch 8.x 安全性**：默认情况下，Elasticsearch 8.x 启用了安全性功能，因此需要在客户端配置中提供用户名和密码。 - **Transport Client 移除**：Elasticsearch 8.x 不再支持 Transport Client，因此必须使用 REST High-Level Client[^2]。 - **依赖管理**：确保在项目的 `pom.xml` 或 `build.gradle` 文件中正确声明了 `spring-boot-starter-data-elasticsearch` 依赖项。 #### Maven 依赖示例 ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-elasticsearch</artifactId> <version>3.3.5</version> </dependency> ``` #### Gradle 依赖示例 ```gradle implementation 'org.springframework.boot:spring-boot-starter-data-elasticsearch:3.3.5' ``` ### 注意事项 - 如果尝试将 Spring Boot 3.3.5 与 Elasticsearch 7.x 配合使用，可能会遇到兼容性问题，因为官方推荐的版本是 Elasticsearch 8.x[^3]。 - 确保 Elasticsearch 服务器版本与客户端库版本匹配，以避免潜在的功能或协议不一致问题。