从 OpenFeign 到 RestClient：Spring Cloud 新时代的轻量化 HTTP 调用方案

一、为什么要替换 OpenFeign？

1. OpenFeign 的困境

OpenFeign 是 Spring Cloud 生态中最常用的声明式 HTTP 客户端，它通过@FeignClient注解让开发者能像调用本地方法一样调用远程服务。然而，随着 Netflix OSS 停止维护，Feign 逐渐陷入以下困境：

• • 配置复杂度：当需要为不同服务配置独立的超时参数或编解码规则时，不得不在启动类堆积大量@FeignClient注解。

• •性能问题：动态代理机制在简化开发的同时，也带来了额外的反射开销。通过JProfiler抽样分析发现，在高并发场景下约有8%的CPU时间消耗在Feign的代理逻辑上。

• •异常处理盲区：默认配置下Feign会将4xx错误直接封装成FeignException抛出，需要开发者手动实现ErrorDecoder才能获取原始响应体。这种设计导致排查问题时总要反复查看日志链路，效率实在难以恭维。

因此，从 Spring Framework 6.1 开始，官方推出了全新的RestClient，意在取代 RestTemplate、部分 WebClient，以及未来的 Feign。

二、RestClient 是什么？

RestClient 是 Spring 官方推出的新一代 HTTP 客户端，它提供：

• • 同步调用（类似 RestTemplate）

• • 响应式调用（基于 WebClient）

• • 集成 Spring Cloud LoadBalancer，实现自动服务发现

• • 与 Declarative HTTP Interface 结合，实现 Feign 风格的声明式调用

基本使用示例

@RestController publicclassUserController { privatefinalRestClientrestClient= RestClient.builder() .baseUrl("http://user-service") .build(); @GetMapping("/users/{id}") public User getUser(@PathVariable Long id) { return restClient.get() .uri("/users/{id}", id) .retrieve() .body(User.class); } }

三、Declarative HTTP Interface：声明式调用新时代

Spring 官方提供了新的声明式调用方式，完全替代 Feign 的写法：

@HttpExchange("/users") public interface UserClient { @GetExchange("/{id}") User getUser(@PathVariable("id") Long id); @PostExchange User createUser(@RequestBody User user); }

创建代理：

@Configuration publicclassClientConfig { @Bean public UserClient userClient(RestClient.Builder builder) { RestClientrestClient= builder.baseUrl("http://user-service").build(); HttpServiceProxyFactoryfactory= HttpServiceProxyFactory.builderFor(RestClientAdapter.create(restClient)).build(); return factory.createClient(UserClient.class); } }

这样调用：

@RestController publicclassTestController { privatefinal UserClient userClient; publicTestController(UserClient userClient) { this.userClient = userClient; } @GetMapping("/demo") public User demo() { return userClient.getUser(1L); } }

四、结合 CircuitBreaker 实现熔断

Spring Boot 3.x 推荐使用Resilience4j实现熔断降级。可以直接将其与 Declarative RestClient 结合。

1. 添加依赖

<dependency> <groupId>io.github.resilience4j</groupId> <artifactId>resilience4j-spring-boot3</artifactId> </dependency>

2. 定义熔断包装器

@Configuration publicclassResilientClientConfig { @Bean public UserClient userClient(RestClient.Builder builder, CircuitBreakerRegistry registry) { CircuitBreakercb= registry.circuitBreaker("userServiceBreaker"); RestClientrestClient= builder.baseUrl("http://user-service").build(); HttpServiceProxyFactoryfactory= HttpServiceProxyFactory.builderFor(RestClientAdapter.create(restClient)) .blockTimeout(Duration.ofSeconds(2)) .build(); UserClientbaseClient= factory.createClient(UserClient.class); return id -> cb.executeSupplier(() -> baseClient.getUser(id)); } }

3. 配置熔断参数

resilience4j: circuitbreaker: instances: userServiceBreaker: slidingWindowSize: 20 failureRateThreshold: 50 waitDurationInOpenState: 10s

五、支持服务发现与负载均衡

引入 Spring Cloud LoadBalancer 后，RestClient 能像 Feign 一样使用逻辑服务名：

<dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-loadbalancer</artifactId> </dependency>

@Bean public RestClient restClient(RestClient.Builder builder) { return builder.baseUrl("http://user-service").build(); }

服务名将自动通过 Nacos / Eureka 解析，无需硬编码 IP。

六、总结

一句话总结：

在 Spring Boot 3.2+ 时代，RestClient + Declarative HTTP Interface + Resilience4j是 Feign 的完美替代方案。

七、实战项目结构图

restclient-demo/ ├── pom.xml ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/restclientdemo/ │ │ │ ├── controller/ │ │ │ │ └── TestController.java │ │ │ ├── client/ │ │ │ │ ├── UserClient.java │ │ │ │ └── ResilientClientConfig.java │ │ │ ├── model/ │ │ │ │ └── User.java │ │ │ └── RestclientDemoApplication.java │ │ └── resources/ │ │ ├── application.yml │ │ └── logback-spring.xml │ └── test/ │ └── java/ │ └── com/example/restclientdemo/ │ └── UserClientTests.java

八、完整依赖列表（pom.xml 片段）

<dependencies> <!-- Spring Boot Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Spring Boot RestClient (Spring 6.1+) --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-webclient</artifactId> </dependency> <!-- Declarative HTTP Interface 支持 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> <!-- 服务发现与负载均衡 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-loadbalancer</artifactId> </dependency> <!-- 熔断降级 Resilience4j --> <dependency> <groupId>io.github.resilience4j</groupId> <artifactId>resilience4j-spring-boot3</artifactId> </dependency> <!-- 注册中心（可选）Eureka 或 Nacos --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId> <optional>true</optional> </dependency> <!-- Lombok --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> <!-- 测试 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-test</artifactId> <scope>test</scope> </dependency> </dependencies>