ReactiveFeignClient注入失败提示无ReactiveFeignBuilder类型Bean如何解决

问题修复方案 #

1. 修正@EnableReactiveFeignClients扫描范围 #

你当前的启动类注解没有指定扫描路径，若MechanicClient所在包不在启动类的包扫描范围内，就会无法生成对应的Bean。修改启动类注解：

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
// 指定Feign接口所在的包路径，或直接指定具体的Client类
@EnableReactiveFeignClients(basePackages = "com.emech.customer.config.feign")
public class CustomerApplication {
    public static void main(String[] args) {
        SpringApplication.run(CustomerApplication.class, args);
    }
}

2. 强制指定Web应用类型为Reactive #

你同时引入了spring-boot-starter-web（Servlet栈）和spring-boot-starter-webflux（响应式栈），Spring默认会优先走Servlet栈，导致Reactive Feign依赖的响应式环境缺失，找不到ReactiveFeignBuilder实例。
在application.yml/application.properties中添加配置：

spring:
  main:
    web-application-type: reactive

或者直接修改启动类main方法：

public static void main(String[] args) {
    SpringApplication app = new SpringApplication(CustomerApplication.class);
    app.setWebApplicationType(WebApplicationType.REACTIVE);
    app.run(args);
}

3. 修正@ReactiveFeignClient属性配置 #

你错误地将服务地址配置到了path属性上，path是接口的统一请求前缀，服务地址需要配置到url属性：

// url填服务根地址，path填接口统一前缀
@ReactiveFeignClient(name = "mechanic-service", url = "${mechanic.service.url}", path = "/mechanic-api")
public interface MechanicClient {
    @GetMapping("/hello")
    Mono<HelloWorldDetails> hi();
}

4. 校验版本匹配 #

你使用的feign-reactor 3.1.1对应适配Spring Boot 2.6.x/2.7.x、Spring Cloud 2021.0.x版本，若你当前Spring Boot版本低于2.6.x，会出现依赖兼容问题，需要升级Spring Boot版本或降级feign-reactor到对应适配版本。

额外说明 #

IntelliJ提示找不到Bean属于IDE索引误报，只要上述配置正确，服务能正常启动就无需处理，也可以在MechanicClient上添加@Component注解消除IDE告警。

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