Feign原理#

// 定义 Feign 客户端接口（无需实现类）
@FeignClient(name = "order-service", fallbackFactory = OrderClientFallback.class)
public interface OrderClient {

    @GetMapping("/api/orders/{id}")
    OrderDTO getOrder(@PathVariable("id") Long id);

    @PostMapping("/api/orders")
    OrderDTO createOrder(@RequestBody CreateOrderRequest request);
}

// 在 Service 中直接注入使用
@Service
public class PaymentService {
    @Autowired
    private OrderClient orderClient;  // 注入接口，底层是动态代理

    public void pay(Long orderId) {
        OrderDTO order = orderClient.getOrder(orderId); // 像调本地方法一样
    }
}

① @EnableFeignClients 启动扫描
   → 扫描所有 @FeignClient 注解的接口
   → 为每个接口注册一个 FeignClientFactoryBean 到 Spring 容器

② FeignClientFactoryBean.getObject()
   → 使用 Feign.Builder 构建代理对象
   → ReflectiveFeign 用 JDK 动态代理（Proxy.newProxyInstance）生成接口的代理实现类（不走 CGLIB）

③ 方法调用触发 InvocationHandler
   → 解析方法上的 @GetMapping / @PostMapping 注解
   → 构建 RequestTemplate（URL、HTTP Method、Header、Body）
   → 将 @PathVariable / @RequestParam / @RequestBody 参数填入模板

④ 请求编码（Encoder）
   → 将请求体序列化为 JSON（默认 Jackson / 可配 Gson）

⑤ 负载均衡（LoadBalancer 拦截）
   → 将 "order-service" 解析为实际 IP:Port
   → 从 Nacos 本地缓存获取实例列表
   → 通过 Spring Cloud LoadBalancer 选择一个实例
   → 替换 URL：http://order-service/api/orders/1 → http://192.168.1.2:8080/api/orders/1

⑥ 发送 HTTP 请求
   → 未引入其他客户端时用 Feign 默认 Client（JDK HttpURLConnection，同步阻塞）
   → 可替换为 Apache HttpClient 5（在 classpath 上即自动启用）/ OkHttp / Http2Client（支持连接池，推荐生产使用）
   → Spring Cloud OpenFeign 4.x 起不再支持 Apache HttpClient 4

⑦ 响应解码（Decoder）
   → 将 HTTP 响应体反序列化为 Java 对象（OrderDTO）

⑧ 异常处理
   → 如果 HTTP 状态码非 2xx → 触发 ErrorDecoder
   → 如果调用超时/失败 → 触发 Retryer 重试（Spring Cloud 默认 Retryer.NEVER_RETRY，不重试）/ 开启 circuitbreaker 后走降级 fallback

# Spring Cloud OpenFeign 4.x 起前缀从 feign.* 改为 spring.cloud.openfeign.*（老前缀不再生效）
spring:
  cloud:
    openfeign:
      client:
        config:
          default:
            connectTimeout: 3000        # 连接超时 3s
            readTimeout: 5000           # 读取超时 5s
            loggerLevel: BASIC          # 日志级别
      compression:
        request:
          enabled: true                 # 请求压缩
        response:
          enabled: true                 # 响应压缩
      okhttp:
        enabled: true                   # 使用 OkHttp 替换默认 HttpURLConnection（需引入 feign-okhttp）
      circuitbreaker:
        enabled: true                   # 开启 Spring Cloud CircuitBreaker，fallback 才生效