使用Eureka时Spring Cloud LoadBalancer请求路由至不可用服务问题

一、Eureka Server与客户端核心配置（解决实例剔除慢+消除警告） #

不要直接关闭自我保护（这是Eureka防止网络波动误删正常实例的核心机制，关闭会触发官方警告），通过调整参数实现快速感知宕机实例：

Server端配置 #

# 保留自我保护（默认开启，无需手动设置）
eureka.server.enable-self-preservation=true
# 调整续约率阈值：当实例续约率低于50%时才触发自我保护，适配多实例场景
eureka.server.renewal-percent-threshold=0.5
# 缩短无效实例清理间隔（默认60s，改为10s加快剔除）
eureka.server.eviction-interval-timer-in-ms=10000

Client端配置（External Service和网关均需配置） #

# 缩短实例续约间隔（默认30s，改为5s让Server更快感知存活状态）
eureka.instance.lease-renewal-interval-in-seconds=5
# 缩短服务失效超时时间（默认90s，改为15s，超时即标记为无效）
eureka.instance.lease-expiration-duration-in-seconds=15
# 缩短客户端拉取最新服务列表的间隔（默认30s，改为5s）
eureka.client.registry-fetch-interval-seconds=5

二、负载均衡配置（解决路由到宕机实例+恢复慢问题） #

启用预定义健康检查（修正之前找不到服务的问题） #

在网关application.properties中添加以下配置，确保绑定Eureka的健康状态：

# 开启负载均衡健康检查
spring.cloud.loadbalancer.health-check.enabled=true
# 健康检查间隔（默认30s，改为5s）
spring.cloud.loadbalancer.health-check.interval=5s
# 指定使用Eureka健康检查器（必须配置，否则无法关联Eureka实例状态）
spring.cloud.loadbalancer.health-check.health-checker=eureka

注意：网关路由必须使用lb://EXTERNAL-SERVICE格式（EXTERNAL-SERVICE为Eureka注册的服务ID），不能硬编码IP地址。

自定义负载均衡客户端的正确用法（解决配置失效问题） #

@LoadBalancerClient注解中的name参数就是你要适配的目标服务ID（即Eureka中注册的External Service服务名），只有调用该服务时才会触发自定义配置。

步骤1：创建自定义配置类（不要放在主类扫描包下，避免全局生效）

public class CustomLoadBalancerConfig {
    // 自定义负载均衡策略（示例：基于健康状态的轮询）
    @Bean
    public ReactorLoadBalancer<ServiceInstance> reactorServiceInstanceLoadBalancer(
            Environment environment,
            LoadBalancerClientFactory loadBalancerClientFactory) {
        String serviceId = environment.getProperty(LoadBalancerClientFactory.PROPERTY_NAME);
        return new RoundRobinLoadBalancer(
                loadBalancerClientFactory.getLazyProvider(serviceId, ServiceInstanceListSupplier.class),
                serviceId
        );
    }

    // 绑定健康检查的服务实例列表提供者
    @Bean
    public ServiceInstanceListSupplier serviceInstanceListSupplier(ConfigurableApplicationContext context) {
        return ServiceInstanceListSupplier.builder()
                .withDiscoveryClient()
                .withHealthChecks()
                .build(context);
    }
}

步骤2：在网关主类绑定配置到目标服务

@SpringBootApplication
// 指定对EXTERNAL-SERVICE服务应用自定义负载均衡配置
@LoadBalancerClient(name = "EXTERNAL-SERVICE", configuration = CustomLoadBalancerConfig.class)
public class GatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }
}

若需全局生效，使用@LoadBalancerClients(defaultConfiguration = CustomLoadBalancerConfig.class)注解。

三、补充信息来源（解决官方文档信息不足问题） #

• 查看依赖源码：直接查看spring-cloud-netflix-eureka-client、spring-cloud-starter-loadbalancer的源码，里面包含所有配置属性的默认值和详细注释，覆盖官方文档未提及的高级参数。
• Spring Cloud Netflix GitHub仓库：仓库的README和Wiki包含Eureka集成的实战细节和常见问题排查。
• Spring Boot Actuator端点：通过网关的/actuator/eureka端点查看客户端缓存的服务实例列表，用于调试实例状态同步问题。

内容的提问来源于stack exchange，提问作者Lawrence Beutlich