OpenFeign 学习笔记
一、基础入门
1.1 简介
-
OpenFeign 是基于声明式的 REST 客户端，用于简化服务间远程调用。（编程式 REST 客户端（RestTemplate））
-
通过接口+注解方式定义 HTTP 请求，自动实现服务调用。
注解驱动
• 指定远程地址：@FeignClient
• 指定请求方式：@GetMapping、@PostMapping、@DeleteMapping …
• 指定携带数据：@RequestHeader、@RequestParam、@RequestBody …
• 指定结果返回：响应模型
-
官网：https://docs.spring.io/spring-cloud-openfeign/reference/spring-cloud-openfeign.html#spring-cloud-feign
-
人话总结：OpenFeign是一种替代RestTemplate的工具，专门用来实现不同微服务之间实现远程调用的业务API，相比RestTemplate功能更强大，操作更简介。
1.2 引入依赖
<!-- Spring Cloud OpenFeign 核心依赖 -->
<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
1.3 开启功能
在主启动类添加注解：
@EnableFeignClients // 启用 OpenFeign 客户端功能
@SpringBootApplication
public class Application { ... }
1.4 远程调用
-
定义 Feign 客户端接口：（客户端：发送请求 服务端：接收请求）
1.1远程调用 - 业务API
@FeignClient(name = "user-service") // 指定服务名称
public interface UserClient {@GetMapping("/user/{id}") // 指定请求路径（发送请求）User getUserById(@PathVariable Long id);
}
1.2远程调用 - 第三方API
tip：如何编写好OpenFeign声明式的远程调用接口？
• 业务API：直接复制对方Controller签名即可
• 第三方API：根据接口文档确定请求如何发
2.注入使用：
@Autowired
private UserClient userClient;
public User getUser(Long id) {return userClient.getUserById(id); // 直接调用远程接口
}
1.5面试题：客户端负载均衡与服务端负载均衡区别？
答：根据负载均衡发生的位置来区分。
负载均衡发生在客户端就是客户端负载均衡。
负载均衡发生在服务端就是服务端负载均衡。
二、进阶配置
2.1 开启日志
配置日志级别（application.yml）：
logging:level:com.example.client.UserClient: DEBUG # 指定客户端接口的日志级别
配置日志策略（Java Config）：
@Configuration
public class FeignConfig {@BeanLogger.Level feignLoggerLevel() {return Logger.Level.FULL; // FULL/BASIC/HEADERS/NONE}
}
2.2 超时控制（避免服务器宕机）
spring:cloud:openfeign:client:config:default: # 全局配置logger-level: fullconnect-timeout: 1000 # 连接超时（ms)read-timeout: 2000 # 读取超时（ms)user-service: # 指定服务的配置logger-level: fullconnect-timeout: 3000read-timeout: 5000
2.3 重试机制
远程调用超时失败后，还可以进行多次尝试，如果某次成功返回ok，如 果多次依然失败则结束调用，返回错误。
spring:cloud:openfeign:client:config:default:retryable: true # 启用重试maxAttempts: 3 # 最大重试次数
或
@Bean
Retryer retryer(){return new Retryer.Default();
}
2.4 Fallback 兜底返回
1.引入 sentinel
<dependency><groupId>com.alibaba.cloud</groupId><artifactId>spring-cloud-starter-alibaba-sentinel</artifactId></dependency>
2.开启熔断
feign:sentinel:enabled: true
3.编写 fallback 函数
@FeignClient(value = "service-product",fallback = ProductFeignClientFallback.class) // feign客户端
public interface ProductFeignClient {//mvc注解的两套使用逻辑//1、标注在Controller上，是接收这样的请求//2、标注在FeignClient上，是发送这样的请求@GetMapping("/product/{id}")Product getProductById(@PathVariable("id") Long id);
}
@Component
public class ProductFeignClientFallback implements ProductFeignClient {@Overridepublic Product getProductById(Long id) {System.out.println("兜底回调....");Product product = new Product();product.setId(id);product.setPrice(new BigDecimal("0"));product.setProductName("未知商品");product.setNum(0);return product;}
}
三、拦截器用法
1.请求拦截器
2.响应拦截器（用的不多）
自定义请求拦截器：
import feign.RequestInterceptor;@Component//如果放入IOC容器就会自动注册拦截器，可以不做后面的注册
public class XTokenRequestInterceptor implements RequestInterceptor {/***请求拦截器*template 请求模板*/@Overridepublic void apply(RequestTemplate template) {System.out.println("XTokenRequestInterceptor.......");template.header("X-Token", "UUID.randomUUID.toString()"); // 添加请求头，用作身份验证}
}
注册拦截器（配置类中）：
@Configuration
public class FeignConfig {@Beanpublic AuthInterceptor authInterceptor() {return new AuthInterceptor();}
}
四、重点总结
| 核心内容 | 关键点 |
|---|---|
| 远程调用客户端 | 通过 @FeignClient 定义接口，使用 @GetMapping 等注解声明 HTTP 方法。 |
| 超时控制 | 配置 connectTimeout 和 readTimeout，支持全局和按服务配置。 |
| 重试机制 | 启用 retryable 并设置 maxAttempts，增强服务调用容错性。 |
| Fallback 兜底 | 实现 Fallback 类处理服务降级，防止级联故障。 |
| 拦截器 | 通过 RequestInterceptor 添加统一请求头或认证信息。 |
注意事项：
- 生产环境建议配置合理的超时时间和重试策略，避免雪崩效应。
- 拦截器可用于统一认证、日志跟踪等场景。
