ReactiveFeignClient报错：注解未被Default契约识别的排查求助

你遇到的报错本质是：Feign默认使用的Default契约只识别自身原生注解（如@RequestLine），完全不支持Spring MVC的@GetMapping，也不兼容@ReactiveFeignClient的配置逻辑，因此提示这些注解“未被契约使用”。

1. 补全核心依赖 #

确保项目引入Reactive Feign必需的依赖（以Maven为例）：

<!-- Spring Cloud OpenFeign 核心依赖 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<!-- 负载均衡依赖（替代Ribbon） -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-loadbalancer</artifactId>
</dependency>
<!-- WebFlux 依赖，支持Reactive编程 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>

WebFlux是Reactive Feign的基础，Loadbalancer负责服务发现与负载均衡，缺一不可。

2. 配置Spring MVC兼容的Feign契约 #

在你指定的CurrencyServiceInternalClientConfiguration类中，添加一个Bean，让Feign使用能识别Spring MVC注解的契约：

@Configuration
public class CurrencyServiceInternalClientConfiguration {

    @Bean
    public Contract feignContract() {
        return new SpringMvcContract();
    }
}

这个配置会告诉Feign：放弃默认契约，改用支持@GetMapping等Spring注解的契约。

3. 确认配置类扫描范围 #

确保CurrencyClientAutoConfiguration和CurrencyServiceClient能被Spring正确扫描：

• 如果自动配置类不在主启动类的同级或子包下，要么调整包结构，要么在主启动类上添加@ComponentScan(basePackages = "你的配置类所在包路径")；
• 嫌麻烦的话，直接在主启动类上添加@EnableReactiveFeignClients(clients = CurrencyServiceClient.class)，替代单独的自动配置类，效果一致。

4. Hystrix适配调整（可选） #

你开启了Hystrix，但Hystrix是阻塞式组件，与Reactive编程兼容性较差：

• 若坚持使用Hystrix，除了保留feign.hystrix.enabled=true，还要在配置类中添加Hystrix Builder Bean：

@Bean
public HystrixFeign.Builder hystrixFeignBuilder() {
    return HystrixFeign.builder();
}

• 更推荐替换为Resilience4j这类原生支持Reactive的断路器组件，使用体验更顺畅。

完成上述配置后重启服务，契约相关报错会消失，Reactive Feign Client可正常调用目标微服务接口。

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