SpringBoot项目中无法创建Elasticsearch Bean的问题求助

问题描述 #

在Spring Boot 3.2.2（Java 17）项目中集成AWS OpenSearch，通过继承ElasticsearchRepository创建ProductSearchRepo接口操作Product实体，但无法创建该Repository的Bean，依赖它的SearchService、SearchController均初始化失败。核心错误日志如下：

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'searchController' defined in file [/Users/aditkumar/Desktop/iRobot/Projects/Product_Service/ProductService_proxy/target/classes/com/example/productservice_proxy/Controllers/SearchController.class]: Unsatisfied dependency expressed through constructor parameter 0: Error creating bean with name 'searchService' defined in file [/Users/aditkumar/Desktop/iRobot/Projects/Product_Service/ProductService_proxy/target/classes/com/example/productservice_proxy/services/SearchService.class]: Unsatisfied dependency expressed through constructor parameter 1: Error creating bean with name 'productSearchRepo' defined in com.example.productservice_proxy.Repositories.ProductSearchRepo defined in @EnableJpaRepositories declared on JpaRepositoriesRegistrar.EnableJpaRepositoriesConfiguration: Could not create query for public abstract void org.springframework.data.elasticsearch.repository.ElasticsearchRepository.delete(java.lang.Object,org.springframework.data.elasticsearch.core.RefreshPolicy); Reason: Failed to create query for method public abstract void org.springframework.data.elasticsearch.repository.ElasticsearchRepository.delete(java.lang.Object,org.springframework.data.elasticsearch.core.RefreshPolicy); No property 'delete' found for type 'Product'; Did you mean 'deleted'

错误原因 #

1. Repository扫描范围冲突：Spring Boot自动配置的@EnableJpaRepositories扫描范围覆盖了ProductSearchRepo，将Elasticsearch Repository误当作JPA Repository处理。JPA的方法解析器无法识别ElasticsearchRepository自带的带RefreshPolicy参数的delete方法，因此报错找不到对应的Product属性。
2. 依赖版本不兼容：使用的spring-data-opensearch 1.3.0适配Spring Boot 2.x，与当前Spring Boot 3.2.2版本不匹配，导致底层组件冲突。
3. 实体类注解冲突：Product类同时标注@Entity（JPA）和@Document（Elasticsearch），且包含JPA专属的@ManyToOne关联注解，Elasticsearch无法识别这些注解，可能引发映射问题。

解决方案 #

1. 隔离Repository扫描范围 #

明确划分JPA和Elasticsearch Repository的包路径，在启动类或配置类中指定各自的扫描范围：

@SpringBootApplication
// 仅扫描JPA Repository所在包
@EnableJpaRepositories(basePackages = "com.example.productservice_proxy.repositories.jpa")
// 仅扫描Elasticsearch Repository所在包
@EnableElasticsearchRepositories(basePackages = "com.example.productservice_proxy.repositories.opensearch")
public class ProductServiceProxyApplication {
    public static void main(String[] args) {
        SpringApplication.run(ProductServiceProxyApplication.class, args);
    }
}

调整包结构：

• 将ProductRepo移至com.example.productservice_proxy.repositories.jpa
• 将ProductSearchRepo移至com.example.productservice_proxy.repositories.opensearch

2. 修正依赖版本 #

替换为适配Spring Boot 3.x的spring-data-opensearch版本，移除冲突的Elasticsearch客户端依赖：

<dependency>
    <groupId>org.opensearch.client</groupId>
    <artifactId>spring-data-opensearch</artifactId>
    <!-- 适配Spring Boot 3.x的版本，如2.2.0 -->
    <version>2.2.0</version>
</dependency>
<!-- 移除旧的Elasticsearch客户端，spring-data-opensearch会自动引入适配的OpenSearch客户端 -->
<!-- <dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level-client</artifactId>
    <version>7.17.17</version>
</dependency> -->

3. 拆分实体类（可选但推荐） #

避免JPA和Elasticsearch实体类混用，创建单独的ProductDocument类用于OpenSearch：

@Getter
@Setter
@Document(indexName = "productservice")
public class ProductDocument {
    private Long id;
    private String title;
    private double price;
    private String description;
    // 仅存储分类名称，而非JPA关联对象
    private String categoryName;
    private String imageUrl;
    private Boolean isPublic;
    private int numberOfUnits;
}

修改ProductSearchRepo的泛型：

@Repository
public interface ProductSearchRepo extends ElasticsearchRepository<ProductDocument, Long> {
    Iterable<ProductDocument> findAllByTitleEquals(String title);

    @Query("{\"query\": {\"match\": {\"title\": \"?0\"}}}")
    List<ProductDocument> findAllByTitleContaining(String query);
    
    void deleteProductById(Long id);
}

同时在SearchService中处理JPA实体到OpenSearch文档的转换逻辑。

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