Spring Boot连接ElasticSearch执行indexExists请求报错如何解决

异常根因分析 #

该异常是Spring Data Elasticsearch在启动阶段校验索引是否存在时，无法正常与Elasticsearch服务端完成通信导致，核心触发原因如下：

• ES服务端地址配置错误：配置类中connectedTo("ElasticSearch Server")为占位符，未替换为实际的ES服务端IP+端口，单节点格式为IP:9200，多节点用逗号分隔即可
• 认证信息不匹配：配置的用户名、密码与ES服务端实际认证信息不符，或账号无索引查询权限
• 版本不兼容：Spring Data Elasticsearch与ES服务端版本差异过大，API调用逻辑不匹配，GetIndexRequest请求结构不符合服务端要求
• 网络连通性异常：应用部署环境与ES服务端的9200端口（HTTPS默认9243）被防火墙、安全组拦截，无法建立TCP连接
• SSL配置缺失：ES服务端开启HTTPS访问但客户端未配置SSL参数，无法完成TLS握手

排查解决步骤 #

1. 修正配置类参数，替换占位符为实际业务配置，示例代码如下：

@Configuration
@EnableElasticsearchRepositories(basePackages = "com.repository")
public class ESConfig extends AbstractElasticsearchConfiguration {

    @Override
    @Bean
    public RestHighLevelClient elasticsearchClient() {

        final ClientConfiguration clientConfiguration = ClientConfiguration.builder()  
            .connectedTo("192.168.1.10:9200") // 替换为实际ES节点地址，多节点用逗号分隔
            .withBasicAuth("实际用户名", "实际密码")
            // ES开启HTTPS时取消下方注释
            // .usingSsl()
            .build();

        return RestClients.create(clientConfiguration).rest();                         
    }
}

2. 验证网络与认证信息有效性：在应用部署服务器执行curl -u 用户名:密码 http://ES地址:9200，若能正常返回ES服务端版本信息则证明网络与认证配置正常，否则先排查安全组、防火墙、账号权限问题
3. 校验版本兼容性：ES服务端主版本需与Spring Data Elasticsearch主版本适配，ES7.x对应Spring Data Elasticsearch 4.x，ES8.x对应Spring Data Elasticsearch 5.x，版本不匹配时调整Spring Boot版本或升级ES服务端即可
4. 索引检查：若ES服务端关闭了自动创建索引配置，需先手动在ES中创建flight索引，再启动应用

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