Spring Boot集成Docker部署ElasticSearch遇searchSimilar属性不存在问题

报错信息 #

Caused by: org.springframework.data.repository.query.QueryCreationException: Could not create query for public abstract org.springframework.data.domain.Page org.springframework.data.elasticsearch.repository.ElasticsearchRepository.searchSimilar(java.lang.Object,java.lang.String[],org.springframework.data.domain.Pageable); Reason: Failed to create query for method public abstract org.springframework.data.domain.Page org.springframework.data.elasticsearch.repository.ElasticsearchRepository.searchSimilar(java.lang.Object,java.lang.String[],org.springframework.data.domain.Pageable); No property 'searchSimilar' found for type 'Items'

问题分析 #

这个错误并非因为你直接调用了searchSimilar方法，而是Spring Data在生成ElasticsearchRepository代理类时，错误地将这个接口内置方法当成了自定义查询方法（按照Spring Data方法名规则解析），导致无法匹配Items实体的属性。常见触发原因：

• Spring Data Elasticsearch与Spring Data JPA版本不兼容，代理逻辑冲突
• @CacheEvict等缓存注解的AOP增强与Repository代理逻辑产生干扰
• private方法上的缓存注解无效，同时可能触发代理类的异常解析逻辑

解决方案 #

1. 统一Spring Data依赖版本

确保Spring Boot、Spring Data Elasticsearch、Spring Data JPA的版本匹配，避免版本不一致导致的代理逻辑冲突。推荐通过Spring Boot parent依赖统一管理版本：

<!-- pom.xml示例 -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.15</version> <!-- 选择稳定兼容的版本 -->
    <relativePath/>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
</dependencies>

2. 修正缓存注解的使用

@CacheEvict加在private方法上是无效的（Spring AOP无法增强private方法），需要将方法改为public，并确保所在类被@Service或@Component标记：

@Service
public class ItemService {
    @Autowired
    private ItemRepository itemRepository;
    @Autowired
    private ItemElasticSearchRepository itemElasticSearchRepository;

    @CacheEvict(value = "items", allEntries = true)  
    public Items saveItem(Items item){
        Items savedItem = itemRepository.save(item);
        itemElasticSearchRepository.save(item);
        return savedItem;
    }
}

3. 自定义Repository接口排除内置方法

如果业务不需要searchSimilar方法，可以自定义基础Repository接口，不继承该方法：

// 自定义基础Elasticsearch Repository
public interface CustomElasticRepo<T, ID> extends ElasticsearchRepository<T, ID> {
    // 不声明searchSimilar方法，避免Spring Data解析
}

// 业务Repository继承自定义接口
public interface ItemElasticSearchRepository extends CustomElasticRepo<Items, String> {
    
}

4. 配置Repository方法解析策略

通过自定义RepositoryFactoryBean，调整方法解析逻辑，让Spring Data识别searchSimilar是内置方法：

@Configuration
@EnableElasticsearchRepositories(basePackages = "com.yourpackage.repository")
public class ElasticsearchConfig {

    @Bean
    public ElasticsearchRepositoryFactoryBean<?, ?, ?> elasticsearchRepositoryFactoryBean() {
        return new ElasticsearchRepositoryFactoryBean<>() {
            @Override
            protected RepositoryFactorySupport createRepositoryFactory() {
                RepositoryFactorySupport factory = super.createRepositoryFactory();
                // 可自定义方法元数据解析器，过滤内置方法
                return factory;
            }
        };
    }
}

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