Eureka Client Instance status DOWN - SpringCloud Eureka 实例状态为DOWN时如何排查问题

﹏ヽ暗。殇╰゛Y 2022-05-22 04:21 254阅读 0赞

# Eureka Client Instance status DOWN - SpringCloud Eureka 实例状态为DOWN时如何排查问题 #

*  Eureka Client Instance status DOWN - SpringCloud Eureka 实例状态为DOWN时如何排查问题
    
     *  发现问题
     *  产生原因
     *  解决问题
     *  事后总结

## 发现问题 ##

启动`spring boot application`注册`euraka client`到`eureka server`后，可以在`eureka.server.ip:port`看到对应的实例列表，但是实例前面有一个红色的`DOWN`:  
![这里写图片描述][70]  
如果用`ip`去访问这个服务的`REST`接口，是完全没有问题的；但是如果用`RestTemplate`或`FeignClient`通过`applicationName`访问就会失败。

## 产生原因 ##

注册到`eureka server`的服务，如果开启了健康检查，`spring boot`程序会隔一小段时间就检查一下配置的一些外部资源是否可用，比如各种数据源是否能联通，如果任意一个配置无法正常连通，就会向`eureka server`推送消息让该实例下线。这相当于是一个`hearbeat`，检查各个实例是否能正常使用。当然自己也可以自己实现`HealthCheckHandler`来个性化健康检测，甚至给一个`REST`接口更改`getStatus()`返回值，以实现主动上下线的操作，具体可以参考这里：[springcloud-eureka集群-健康检测][springcloud-eureka_-]。

其中，打开健康检测的功能需要有以下配置：  
`pom`中引入

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>

`application.properties`需要打开健康检测：

eureka.client.healthcheck.enabled = true

启动应用后，就可以通过访问：  
`${spring.cloud.client.ipAddress}:${server.port}[/server.contextPath]/health`  
来查看健康情况，正常时返回：

{"details":{},"status":{"code":"UP","description":"Spring Cloud Eureka Discovery Client"}}

异常时返回：

{"details":{},"status":{"code":"DOWN","description":""}}

`Eureka`服务中心的状态就根据这些数据来更新的。

## 解决问题 ##

找到问题的源头就可以很快解决了。  
首先，访问一下  
`${spring.cloud.client.ipAddress}:${server.port}[/server.contextPath]/health`（如果状态是`DOWN`，健康检测机制会多次重试确保真的挂了，所以可能会等待稍长的时间才会返回结果），如果这里是真的`DOWN`，那么就可以断定是某个资源不可用导致的，一般日志里都有打印错误，比如`MySQL`挂了，日志就会不停地打印：

...
    [2018-06-14 20:26:16] [http-nio-8089-exec-2] [ERROR] [com.alibaba.druid.filter.logging.Log4jFilter:152] {conn-10002, stmt-20007} execute error. SELECT 1
    com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure
    ...

如果无法访问  
`${spring.cloud.client.ipAddress}:${server.port}[/server.contextPath]/health`这个接口，等到烟火清凉也没有返回，而且应用并未配置任何外部资源、或者所有外部资源确认可以访问，说明这个应用思想出问题了，这次我遇到的就是这个情况。这时要特别留意日志里的`WARN`级别信息，这些`WARN`相当重要，这次问题遇到了`8`行`WARN`：

[2018-06-14 19:51:54] [main] [WARN] [org.mybatis.spring.mapper.ClassPathMapperScanner:166] No MyBatis mapper was found in '[com.xx.xx.core, com.xx.xx]' package. Please check your configuration.
    [2018-06-14 19:51:55] [main] [WARN] [org.mybatis.spring.mapper.ClassPathMapperScanner:166] No MyBatis mapper was found in '[com.xx.xx.**.mapper]' package. Please check your configuration.
    [2018-06-14 19:51:55] [main] [WARN] [org.springframework.context.annotation.ConfigurationClassPostProcessor:373] Cannot enhance @Configuration bean definition 'myBatisMapperScannerConfig' since its singleton instance has been created too early. The typical cause is a non-static @Bean method with a BeanDefinitionRegistryPostProcessor return type: Consider declaring such methods as 'static'.
    [2018-06-14 19:52:05] [main] [WARN] [com.netflix.config.sources.URLConfigurationSource:121] No URLs will be polled as dynamic configuration sources.
    [2018-06-14 19:52:05] [main] [WARN] [com.netflix.config.sources.URLConfigurationSource:121] No URLs will be polled as dynamic configuration sources.
    [2018-06-14 19:52:05] [main] [WARN] [org.springframework.boot.autoconfigure.thymeleaf.AbstractTemplateResolverConfiguration:60] Cannot find template location: classpath:/templates/ (please add some templates or check your Thymeleaf configuration)
    [2018-06-14 19:52:09] [DiscoveryClient-InstanceInfoReplicator-0] [WARN] [com.netflix.discovery.DiscoveryClient$3:1277] Saw local status change event StatusChangeEvent [timestamp=1528977129378, current=DOWN, previous=UP]
    [2018-06-14 19:52:09] [DiscoveryClient-InstanceInfoReplicator-0] [WARN] [com.netflix.discovery.InstanceInfoReplicator:93] Ignoring onDemand update due to rate limiter

前两个`WARN`基本就可以定位到问题了，因为当前应用没有任何外部资源，提示里不存在的两个包路径也没有在任何地方有配置，这就说明一定是父项目或者依赖项目有导致`DOWN`的配置，果不其然，依赖了一个包，里面有数据库配置，而且连不上……`exclusion`掉对应的包，一切正常了。

`/health`接口无法访问的原因可能也是因为重试，资源的具体配置是在父项目或者依赖项目中，可能无法正常请求或返回，导致一直卡住（不确定是这个原因）。

后面有两个`WARN`提示了状态变更，如果想看所有动作日志，还可以在`logback`中打开`DEBUG`，就会清楚地看到向`eureka server PUT`状态的`HTTP`请求详情。

## 事后总结 ##

解决问题的时候走了一些弯路，包括到`sping cloud github`上找`issues`，以为是`spring boot`和`spring cloud`版本冲突，以为是父项目和子项目的版本冲突等等，其实就是有外部资源检查不可用，主要是访问`/health`接口失败断了节奏。

[70]: /images/20220522/80c35a78a47f4294817136a6eda4b672.png
[springcloud-eureka_-]: https://blog.csdn.net/wgxaszc8/article/details/79064867