Spring Cloud LoadBalancer开启健康检查结合自定义配置失效问题咨询

• 下游服务健康检查端点不可访问：Spring Cloud LoadBalancer默认会调用下游服务的/actuator/health接口做存活判定，若下游service-api未引入spring-boot-starter-actuator依赖，即使配置了端点暴露规则，该接口也不存在，健康检查会标记所有实例为不可用，最终抛出无可用服务报错。
• 健康检查配置不匹配：使用无参withHealthChecks()方法时，会读取默认的健康检查规则，若下游服务自定义了管理端口、端点前缀，或者实例注册的元数据缺少健康检查相关配置，会导致健康检查请求路径、端口不匹配，检查失败。
• 初始调用时机过早：默认健康检查第一次执行存在延迟，在首次检查结果返回前，所有实例都会被标记为不可用，若客户端启动后立即调用接口就会触发报错。

1. 补全下游服务依赖
   给service-api服务添加actuator起步依赖，确保健康检查端点可正常访问：

<!-- Maven依赖配置 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

若下游服务配置了management.server.port或者management.endpoints.web.base-path，需要同步修改健康检查路径为实际的访问地址。

2. 显式配置健康检查规则
   修改自定义LoadBalancerConfiguration类，传入自定义的健康检查配置替换默认规则：

public class LoadBalancerConfiguration {

    @Bean
    public ServiceInstanceListSupplier instanceSupplier(ConfigurableApplicationContext context) {
        HealthCheckServiceInstanceListSupplierConfig healthCheckConfig = 
            new HealthCheckServiceInstanceListSupplierConfig();
        // 配置实际的健康检查路径
        healthCheckConfig.setHealthCheckPath("/actuator/health");
        healthCheckConfig.setConnectTimeout(1000);
        healthCheckConfig.setReadTimeout(1000);
        
        return ServiceInstanceListSupplier.builder()
                .withDiscoveryClient()
                .withHealthChecks(healthCheckConfig)
                .withCaching() // 添加缓存减少重复检查开销
                .build(context);
    }
}

3. 调整健康检查时序配置
   在负载均衡客户端的配置文件中添加如下配置，给实例预留启动时间避免初始调用失败：

# 首次健康检查初始延迟，单位毫秒
spring.cloud.loadbalancer.health-check.initial-delay=1000
# 健康检查间隔
spring.cloud.loadbalancer.health-check.interval=5s

内容的提问来源于stack exchange，提问作者Nikhilesh Y