聊聊 Feign 的实现原理

最新推荐文章于 2025-05-13 16:54:18 发布

原创

最新推荐文章于 2025-05-13 16:54:18 发布 · 960 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

Feign是一个基于接口和注解的HTTP客户端，简化了HTTP请求的调用。它封装了HTTP请求调用流程，使得在微服务中调用HTTP服务更加简单。本文介绍了Feign的基本概念、为何使用Feign，以及通过示例展示了如何原生和结合Spring Cloud使用Feign。在内部，Feign通过动态代理生成接口实现，调用时通过FeignInvocationHandler处理HTTP请求，实现了请求的发送和响应的解码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

What is Feign

Feign 是⼀个 HTTP 请求的轻量级客户端框架。通过接口 + 注解的方式发起 HTTP 请求调用，面向接口编程，而不是像 Java 中通过封装 HTTP 请求报文的方式直接调用。服务消费方拿到服务提供方的接⼝，然后像调⽤本地接⼝⽅法⼀样去调⽤，实际发出的是远程的请求。让我们更加便捷和优雅的去调⽤基于 HTTP 的 API，被⼴泛应⽤在 Spring Cloud 的解决⽅案中。开源项目地址： Feign ，官方描述如下：

Feign is a Java to HTTP client binder inspired by Retrofit, JAXRS-2.0, and WebSocket. Feign’s first goal was reducing the complexity of binding Denominator uniformly to HTTP APIs regardless of ReSTfulness.

Why Feign

Feign 的首要目标就是减少 HTTP 调用的复杂性。在微服务调用的场景中，我们调用很多时候都是基于 HTTP 协议的服务，如果服务调用只使用提供 HTTP 调用服务的 HTTP Client 框架（e.g. Apache HttpComponnets、HttpURLConnection OkHttp 等），我们需要关注哪些问题呢？

相比这些 HTTP 请求框架，Feign 封装了 HTTP 请求调用的流程，而且会强制使用者去养成面向接口编程的习惯（因为 Feign 本身就是要面向接口）。

Demo

原生使用方式

以获取 Feign 的 GitHub 开源项目的 Contributors 为例，原生方式使用 Feign 步骤有如下三步（这里以使用 Gradle 进行依赖管理的项目为例）： 第一步： 引入相关依赖：implementation ‘io.github.openfeign:feign-core:11.0’ 在项目的 build.gradle 文件的依赖声明处 dependencies 添加该依赖声明即可。

第二步：声明 HTTP 请求接口使用 Java 的接口和 Feign 的原生注解 @RequestLine 声明 HTTP 请求接口，从这里就可以看到 Feign 给使用者封装了 HTTP 的调用细节，极大的减少了 HTTP 调用的复杂性，只要定义接口即可。

第三步：配置初始化 Feign 客户端最后一步配置初始化客户端，这一步主要是设置请求地址、编码（Encoder）、解码（Decoder）等。

通过定义接口，使用注解的方式描述接口的信息，就可以发起接口调用。最后请求结果如下：

结合 Spring Cloud 使用方式

同样还是以获取 Feign 的 GitHub 开源项目的 Contributors 为例，结合 Spring Cloud 的使用方式有如下三步： 第一步： 引入相关 starter 依赖：org.springframework.cloud:spring-cloud-starter-openfeign 在项目的 build.gradle 文件的依赖声明处 dependencies 添加该依赖声明即可。

第二步：在项目的启动类 XXXApplication 上添加 @EnableFeignClients 注解启用 Feign 客户端功能。

第三步：创建 HTTP 调用接口，并添加声明 @FeignClient 注解。最后一步配置初始化客户端，这一步主要是设置请求地址（url）、编码（Encoder）、解码（Decoder）等，与原生使用方式不同的是，现在我们是通过 @FeignClient 注解配置的 Feign 客户端属性，同时请求的 URL 也是使用的 Spring MVC 提供的注解。