Spring 6 引入 HTTP 接口特性替代 Feign
基于 Spring 6 的声明式 HTTP 客户端新实践
Spring 6 的首个正式版本带来了显著的架构演进，其中最值得关注的是引入了原生的 HTTP 接口（HTTP Interface） 特性。该功能旨在以更简洁、类型安全的方式实现远程服务调用，逐步取代传统如 Feign 等第三方解决方案，推动 HTTP 客户端开发标准化。
快速构建一个演示项目
首先创建一个基础的 Spring Boot 应用作为模拟后端服务。定义一个简单的用户实体类：
public class UserInfo implements Serializable {
private int id;
private String username;
// 构造函数、getter、setter 省略
@Override
public String toString() {
return id + ":" + username;
}
}
对应提供一个 REST 接口用于返回用户列表：
@GetMapping("/api/users")
public List<UserInfo> fetchAllUsers() {
return IntStream.rangeClosed(1, 10)
.mapToObj(i -> new UserInfo(i, "User" + i))
.collect(Collectors.toList());
}
确保启动后可通过 http://localhost:8080/api/users 正常访问数据。
配置前端客户端工程
新建一个 Spring Boot 3.0+ 工程（对应 Spring Framework 6），并启用 Java 17 及以上版本。在依赖中引入以下模块：
- spring-web
- spring-web-reactive
说明：当前版本仅支持基于 Reactive 模型的 WebClient 适配器。
定义声明式接口
创建一个接口来描述远程调用行为：
public interface RemoteUserService {
@HttpExchange(url = "/api/users", method = "GET")
List<UserInfo> fetchUserList();
}
所有注解均位于
org.springframework.web.service.annotation包下，@HttpExchange是核心标记，支持多种方法映射。
实例化并执行请求
在测试类中通过工厂模式创建代理实例：
@Test
void testFetchUsers() {
WebClient webClient = WebClient.builder()
.baseUrl("http://localhost:8080/")
.build();
HttpServiceProxyFactory factory = HttpServiceProxyFactory.builder(
WebClientAdapter.forClient(webClient)
).build();
RemoteUserService client = factory.createClient(RemoteUserService.class);
List<UserInfo> users = client.fetchUserList();
users.forEach(System.out::println);
}
运行结果将输出 10 条用户信息，验证调用成功。
注解机制详解
@HttpExchange 支持丰富的配置选项，包括：
url: 请求路径（可含占位符）method: HTTP 方法（默认为自动推断）contentType: 请求体内容类型accept: 响应期望的 MIME 类型
此外，还支持与 Spring MVC 相同的参数绑定能力，例如：
@HttpExchange(url = "/api/users/{id}", method = "GET")
UserInfo getUserById(@PathVariable("id") int userId);
代理对象生成原理
创建的接口实例并非普通实现类，而是一个由 Spring 动态生成的 AOP 代理对象。它在运行时拦截方法调用，并通过底层的 WebClient 发起实际网络请求。
虽然目前需手动使用 HttpServiceProxyFactory，但未来版本预计会引入类似 @EnableHttpClients 这类便捷注解，进一步降低使用门槛。
为何必须依赖 reactive 模块？
尽管可以使用同步风格编写代码，但当前实现强制依赖 spring-web-reactive，因为其底层采用 WebClient 作为唯一内置适配器。这是由于 Spring 6 对响应式编程的支持是优先级最高的设计方向。
后续版本可能推出基于 RestTemplate 的替代方案，但短期内仍以异步非阻塞模型为主流。
其他高级特性
- 支持泛型返回值
- 自定义异常处理器（通过
@Error注解） - 与
@RequestBody、@RequestParam等注解兼容 - 可结合
@RequestHeader、@CookieValue等完成完整请求构建
总结
随着 Spring 6 推出内建的声明式 HTTP 客户端能力，开发者不再需要引入外部库（如 Feign）即可实现高效、类型安全的服务间通信。这一变化标志着 Spring 正在统一和简化远程调用生态，使开发者更聚焦于业务逻辑本身。
未来版本将持续优化易用性，建议关注官方动态，及时掌握最新进展。
