升级Spring Boot 3.0.0出现ReactiveDiscoveryClient Bean缺失，如何修复？

升级至Spring Boot 3.0.0后，网关应用启动时出现如下错误：

Parameter 0 of method dynamicRoutes in org.sid.gateway.GatewayApplication required a bean of type 'org.springframework.cloud.client.discovery.ReactiveDiscoveryClient' that could not be found.

相关代码（GatewayApplication.java）如下：

package org.sid.gateway;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.ReactiveDiscoveryClient;
import org.springframework.cloud.gateway.discovery.DiscoveryClientRouteDefinitionLocator;
import org.springframework.cloud.gateway.discovery.DiscoveryLocatorProperties;
import org.springframework.cloud.gateway.route.RouteLocator;
import org.springframework.cloud.gateway.route.builder.RouteLocatorBuilder;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class GatewayApplication {

    public static void main(String[] args) {
        SpringApplication.run(GatewayApplication.class, args);
    }

    public RouteLocator routes(RouteLocatorBuilder builder) {
        return builder.routes()
                .route(r -> r.path("/customers/**").uri("lb://CUSTOMER-SERVICE"))
                .route(r -> r.path("/products/**").uri("lb://INVENTORY-SERVICE"))
                .build();
    }

    @Bean
    public DiscoveryClientRouteDefinitionLocator dynamicRoutes(ReactiveDiscoveryClient rdc, DiscoveryLocatorProperties dlp) {
        return new DiscoveryClientRouteDefinitionLocator(rdc, dlp);
    }

}

修复方案 #

1. 引入正确的服务发现依赖 #

Spring Boot 3.x对应Spring Cloud 2022.0.x版本，需要根据你使用的服务发现组件（Eureka、Nacos等）引入对应的Reactive客户端starter：

• 若使用Eureka：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

• 若使用Nacos：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2. 显式启用服务发现客户端 #

在启动类上添加@EnableDiscoveryClient注解，确保Spring能识别并加载服务发现相关Bean：

@SpringBootApplication
@EnableDiscoveryClient
public class GatewayApplication {
    // 原有代码保持不变
}

3. 移除自定义的DiscoveryClientRouteDefinitionLocator Bean #

Spring Cloud Gateway 3.1+版本中，当引入服务发现依赖并启用后，DiscoveryClientRouteDefinitionLocator会被自动配置。手动创建该Bean不仅多余，还可能和自动配置的Bean冲突，直接移除这段代码即可：

// 删除以下代码块
/*
@Bean
public DiscoveryClientRouteDefinitionLocator dynamicRoutes(ReactiveDiscoveryClient rdc, DiscoveryLocatorProperties dlp) {
    return new DiscoveryClientRouteDefinitionLocator(rdc, dlp);
}
*/

4. 检查服务发现配置 #

确保配置文件中正确配置了服务发现地址，以Eureka为例（application.properties）：

spring.application.name=GATEWAY-SERVICE
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
eureka.instance.prefer-ip-address=true

内容的提问来源于stack exchange，提问作者Đỗ Như Vỹ