springBoot集成Elasticsearch 报错 Health check failed的解决

下面是针对“springBoot集成Elasticsearch 报错 Health check failed的解决”的完整攻略：

问题背景

在使用SpringBoot集成Elasticsearch时，可能会遇到一些报错，其中之一就是“Health check failed”的报错。这个报错通常会出现在应用程序的启动过程中，导致无法正常启动应用程序。那么这个问题该如何解决呢？下面是详细的攻略。

解决步骤

1. 检查Elasticsearch的状态

在出现Health check failed的报错时，首先需要检查一下Elasticsearch的状态，确保其能正常运行。可以使用以下命令来检查：

$ curl -X GET http://localhost:9200/_cat/health?v

如果Elasticsearch的状态不是green，那么需要进一步检查其它错误。

2. 检查Elasticsearch的日志

如果Elasticsearch的状态是green，那么就需要检查一下它的日志，看看是否有其它错误。Elasticsearch的日志通常位于/var/logs/elasticsearch/目录下，可以使用以下命令来查看最近几条日志：

$ tail -n 100 /var/logs/elasticsearch/elasticsearch.log

如果发现了异常的日志信息，那么根据具体的日志信息来解决问题。

3. 检查SpringBoot应用程序的配置

如果经过了前两步的检查，仍然无法解决问题，那么就需要检查SpringBoot应用程序的配置。特别是在使用SpringBoot集成Elasticsearch时，需要检查以下配置项：

3.1 端口号

默认情况下，Elasticsearch的端口号是9300（Java API）和9200（HTTP API）。因此，在SpringBoot应用程序中配置的Elasticsearch的端口号，应该是这两个端口号中的一个。例如：

spring.elasticsearch.jest.uris=http://localhost:9200
spring.elasticsearch.rest.uris=http://localhost:9200

3.2 集群名称

当SpringBoot应用程序与Elasticsearch集群进行通信时，需要指定集群的名称，在SpringBoot应用程序中配置的Elasticsearch的集群名称，应该是集群中的实际名称。例如：

spring.elasticsearch.jest.settings.cluster-name=my-cluster
spring.elasticsearch.rest.settings.cluster-name=my-cluster

4. 检查Elasticsearch的插件

还有一个经常被忽略的问题是Elasticsearch插件的问题。当安装或使用某些插件时，可能会出现与Elasticsearch的版本不兼容的问题，从而导致Health check failed的报错。因此，在出现这个问题时，应该检查一下是否安装了某些插件，并尝试卸载它们来解决问题。

5. 确认Elasticsearch版本

最后一个需要确认的问题是版本号的问题。SpringBoot的版本通常与Elasticsearch有一定的兼容性要求，因此需要确认目前使用的SpringBoot版本是否与Elasticsearch版本兼容，需要确认使用的依赖库（elasticsearch、spring-data-elasticsearch、spring-boot-starter-data-elasticsearch等）的版本是否一致并且与Elasticsearch兼容。

示例

为了更好的理解，下面我们举两个实际的问题及其解决方法。

示例1

在使用SpringBoot集成Elasticsearch时，出现了以下报错：

org.elasticsearch.cluster.block.ClusterBlockException: blocked by: [SERVICE_UNAVAILABLE/1/state not recovered / initialized];

通过检查Elasticsearch的日志，发现有以下错误信息：

[2018-07-16T10:53:19,091][INFO ][o.e.b.BootstrapChecks    ] [node-1] bound or publishing to a non-loopback address, enforcing bootstrap checks
[2018-07-16T10:53:19,101][ERROR][o.e.b.Bootstrap          ] [node-1] node validation exception
[1] bootstrap checks failed
[1]: max number of threads [1024] for user [elasticsearch] is too low, increase to at least [2048]

通过查阅资料可知，这是由于系统设置了Elasticsearch使用的最大线程数过少导致的。需要修改系统参数限制线程数，具体操作如下。

打开/etc/security/limits.conf文件，添加以下内容：

elasticsearch soft nofile 65536
elasticsearch hard nofile 65536
elasticsearch soft nproc 2048
elasticsearch hard nproc 2048

然后，在/etc/sysctl.conf文件中添加以下内容：

vm.max_map_count=262144

保存修改后，重启系统即可。

示例2