Spring Boot升级后Spring Data Elasticsearch对接AWS OpenSearch兼容性咨询

兼容性结论 #

spring-data-elasticsearch 5.2.x + Elasticsearch 8.11.4 + Spring Framework 6.1.x这个组合完全可以正常对接AWS OpenSearch，但要注意匹配AWS OpenSearch的版本：

• AWS OpenSearch 2.x系列（对应Elasticsearch 7.10+兼容层）直接适配该组合
• 若使用AWS OpenSearch 1.x系列，建议优先升级到2.x；如果无法升级，需要额外配置兼容模式才能正常连接

升级后报错的根源 #

你遇到的Elasticsearch version 6 or more is required错误，是因为spring-data-elasticsearch 5.1.4的版本检测逻辑无法正确识别AWS OpenSearch返回的版本标识（比如OpenSearch/2.11.0），误判服务端版本过低。而5.2.x版本修复了这个识别问题，能正确解析OpenSearch的版本信息，不会再触发该错误。

依赖升级的关键注意事项 #

• 同步升级Spring Boot到3.3.x：Spring Framework 6.1.x对应Spring Boot 3.3.x版本，把Spring Boot从3.2.4升到3.3.x（比如3.3.0）能避免框架依赖冲突
• 统一Elasticsearch相关依赖版本：所有elasticsearch-*（rest-client、core等）依赖必须和8.11.4保持一致，排除Spring Boot默认引入的旧版本
• 不要手动指定Lucene版本：spring-data-elasticsearch 5.2.x会自动引入Elasticsearch 8.11.4对应的Lucene 9.8.0，手动指定8.11.1必然导致依赖冲突
• 配置AWS签名认证：如果你的AWS OpenSearch开启了IAM权限控制，需要配置AWS签名逻辑，推荐用aws-opensearch-spring-boot-starter简化配置，不用手动处理签名细节

快速验证步骤 #

1. 调整项目依赖（以Maven为例）：

   <!-- 升级Spring Boot到3.3.x -->
   <parent>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-parent</artifactId>
       <version>3.3.0</version>
       <relativePath/>
   </parent>
   
   <!-- 指定Spring Data Elasticsearch 5.2.x版本 -->
   <dependency>
       <groupId>org.springframework.data</groupId>
       <artifactId>spring-data-elasticsearch</artifactId>
       <version>5.2.4</version>
   </dependency>
   
   <!-- 匹配Elasticsearch 8.11.4的Rest客户端 -->
   <dependency>
       <groupId>org.elasticsearch.client</groupId>
       <artifactId>elasticsearch-rest-high-level-client</artifactId>
       <version>8.11.4</version>
   </dependency>
   

2. 配置OpenSearch连接：

   @Configuration
   public class OpenSearchConfig {
       @Bean
       public RestHighLevelClient restHighLevelClient(AwsSdk2ClientConfigurer configurer) {
           RestClientBuilder builder = RestClient.builder(
               new HttpHost("your-opensearch-endpoint", 443, "https")
           );
           configurer.configureRestClient(builder);
           return new RestHighLevelClient(builder);
       }
   }
   

3. 启动应用，先检查版本检测错误是否消失，再验证索引创建、数据CRUD等核心功能是否正常

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