Spring Boot使用ElasticsearchRepository启动找不到elasticsearchTemplate怎么解决

核心问题说明 #

你遇到的elasticsearchTemplate bean缺失错误，本质是Spring Boot的Elasticsearch自动配置未正常触发，常见触发原因及对应解决方法如下： #

解决步骤 #

1. 核对版本兼容性 #

Spring Boot、Spring Data Elasticsearch、Elasticsearch服务端三者必须严格匹配版本，否则自动配置会直接失效：

• Spring Boot 2.6.x ~ 2.7.x 对应 Elasticsearch服务端 7.17.x 版本
• Spring Boot 3.0.x ~ 3.2.x 对应 Elasticsearch服务端 8.5.x ~ 8.11.x 版本
  先确认你部署的Elasticsearch服务端版本，再调整pom/gradle中的Spring Boot版本对应匹配即可。

2. 补充Repository扫描注解 #

在你的启动类或者自定义配置类上添加@EnableElasticsearchRepositories注解，显式指定Repository的扫描路径：

@SpringBootApplication
@EnableElasticsearchRepositories(basePackages = "com.user.repository") // 替换为你实际的UserRepo所在包路径
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 显式注册ElasticsearchTemplate（可选，自动配置失效时使用） #

如果上述两步操作后依旧报错，可以手动编写配置类注册相关bean，底层复用的RestHighLevelClient仅作为Spring Data Elasticsearch的底层依赖，你无需直接操作该客户端，依旧可以正常使用ElasticsearchRepository完成所有CRUD：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.elasticsearch.core.ElasticsearchRestTemplate;
import org.springframework.data.elasticsearch.client.ClientConfiguration;
import org.springframework.data.elasticsearch.client.RestClients;
import org.springframework.beans.factory.annotation.Value;
import java.time.Duration;

@Configuration
public class EsConfig {

    @Value("${spring.elasticsearch.rest.uris}")
    private String esUris;
    @Value("${spring.elasticsearch.rest.username}")
    private String username;
    @Value("${spring.elasticsearch.rest.password}")
    private String password;
    @Value("${spring.elasticsearch.rest.connection-timeout}")
    private Duration connectTimeout;
    @Value("${spring.elasticsearch.rest.read-timeout}")
    private Duration readTimeout;

    @Bean
    public RestHighLevelClient elasticsearchClient() {
        ClientConfiguration clientConfiguration = ClientConfiguration.builder()
                .connectedTo(esUris.replace("http://", ""))
                .withBasicAuth(username, password)
                .withConnectTimeout(connectTimeout)
                .withSocketTimeout(readTimeout)
                .build();
        return RestClients.create(clientConfiguration).rest();
    }

    @Bean
    public ElasticsearchOperations elasticsearchTemplate() {
        return new ElasticsearchRestTemplate(elasticsearchClient());
    }
}

额外注意事项 #

• 你的User实体类上的@Document注解中的type属性在Elasticsearch 7.x及以上版本已经废弃，直接删除该属性即可，避免序列化报错。
• 建议在Service层注入ElasticsearchOperations接口，而非直接注入ElasticsearchRestTemplate实现类，降低耦合度。

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