SpringBoot集成ElasticSearch配置用户名密码及适配版本咨询

我来帮你梳理下SpringBoot集成带权限验证的ElasticSearch的具体步骤和版本选择建议，这些都是实际项目里经过验证的稳定方案：

一、版本匹配建议 #

版本兼容性是核心，选错版本会导致各种奇怪的报错，一定要对应上：

• 如果用SpringBoot 2.x（比如2.7.x系列，是2.x的LTS版本），建议搭配ElasticSearch 7.17.x（7系列的LTS版本，稳定性拉满）
• 如果用SpringBoot 3.x（比如3.1.x、3.2.x系列），建议搭配ElasticSearch 8.7.x及以上，这组组合和SpringBoot 3的API适配度最高

二、配置方式 #

1. 配置文件快速配置（推荐） #

首先确保项目引入了对应的ElasticSearch starter依赖：

<!-- SpringBoot 2.x 直接引入 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>

<!-- SpringBoot 3.x 引入（版本随SpringBoot父工程即可） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>

然后在application.yml（或application.properties）里添加权限相关配置：

spring:
  elasticsearch:
    uris: http://your-es-server-ip:9200  # 多节点用逗号分隔，比如http://es1:9200,http://es2:9200
    username: elastic  # ES默认超级用户名是elastic，也可以用你自定义的权限用户
    password: your-es-password  # 你在ES里设置的用户密码
    connection-timeout: 10s  # 可选，设置连接超时时间
    socket-timeout: 30s  # 可选，设置套接字超时时间

如果你的项目用的是旧版RestHighLevelClient（SpringBoot 2.x早期版本可能用这个），配置格式略有不同：

spring:
  elasticsearch:
    rest:
      uris: http://your-es-server-ip:9200
      username: elastic
      password: your-es-password

2. 自定义代码配置（灵活场景） #

如果需要更灵活的配置（比如添加SSL验证、自定义连接池参数），可以写一个配置类：

SpringBoot 3.x 适配新的ElasticsearchClient

import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.elasticsearch.client.ClientConfiguration;
import org.springframework.data.elasticsearch.client.elc.ElasticsearchClient;
import org.springframework.data.elasticsearch.client.elc.ElasticsearchClients;

@Configuration
public class ElasticsearchConfig {

    @Value("${spring.elasticsearch.uris}")
    private String esUris;

    @Value("${spring.elasticsearch.username}")
    private String username;

    @Value("${spring.elasticsearch.password}")
    private String password;

    @Bean
    public ElasticsearchClient elasticsearchClient() {
        ClientConfiguration clientConfiguration = ClientConfiguration.builder()
                .connectedTo(esUris.split(","))
                .withBasicAuth(username, password)
                // 若ES开启了HTTPS，添加下面的SSL配置
                // .usingSsl()
                .build();

        return ElasticsearchClients.createElasticsearchClient(clientConfiguration);
    }
}

SpringBoot 2.x 适配RestHighLevelClient

import org.apache.http.HttpHost;
import org.apache.http.auth.AuthScope;
import org.apache.http.auth.UsernamePasswordCredentials;
import org.apache.http.client.CredentialsProvider;
import org.apache.http.impl.client.BasicCredentialsProvider;
import org.elasticsearch.client.RestClient;
import org.elasticsearch.client.RestHighLevelClient;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class ElasticsearchConfig {

    @Value("${spring.elasticsearch.rest.uris}")
    private String esUris;

    @Value("${spring.elasticsearch.rest.username}")
    private String username;

    @Value("${spring.elasticsearch.rest.password}")
    private String password;

    @Bean
    public RestHighLevelClient restHighLevelClient() {
        CredentialsProvider credentialsProvider = new BasicCredentialsProvider();
        credentialsProvider.setCredentials(AuthScope.ANY,
                new UsernamePasswordCredentials(username, password));

        String[] uris = esUris.split(",");
        HttpHost[] httpHosts = new HttpHost[uris.length];
        for (int i = 0; i < uris.length; i++) {
            httpHosts[i] = HttpHost.create(uris[i].trim());
        }

        return new RestHighLevelClient(
                RestClient.builder(httpHosts)
                        .setHttpClientConfigCallback(httpClientBuilder ->
                                httpClientBuilder.setDefaultCredentialsProvider(credentialsProvider)));
    }
}

三、注意事项 #

• 权限校验：确保你用的ES用户拥有目标索引的读写权限，避免出现403权限报错
• HTTPS适配：如果ES开启了HTTPS，记得在配置里添加SSL相关配置（比如导入信任证书）
• 测试验证：可以写个简单的测试类，调用ES的集群健康查询接口，确认配置是否生效

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