当你配置了feign.sentinel.enable=true时发生什么

详细解释一下 feign.sentinel.enable=true 开启后的 OpenFeign 降级原理，包括它的底层机制和调用链。

1. 背景

在 Spring Cloud Alibaba 中，Sentinel 不只是做接口限流、熔断，还能跟 OpenFeign 集成。

当 feign.sentinel.enable=true 时，Feign 客户端调用远程服务失败、超时或被 Sentinel 规则拦截时，可以走 降级逻辑（fallback） 。

2. 核心原理

开启 feign.sentinel.enable=true 后，Feign 的调用链会被替换为 Sentinel 包装的 Feign Invocation Handler。

2.1 关键替换点

默认情况下，Feign 调用是通过 ReflectiveFeign.FeignInvocationHandler 执行的。
当开启 feign.sentinel.enable=true，SentinelFeign 会替换掉这个 Handler。
替换发生在 SentinelFeign.Builder 中，它会生成一个 SentinelInvocationHandler。

scss 复制代码

public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    // 创建 Sentinel Resource Name
    String resourceName = target.type().getName() + "#" + method.getName();
    
    // 用 SphU.entry 进入 Sentinel 资源保护
    Entry entry = SphU.entry(resourceName, EntryType.OUT);
    
    try {
        return methodHandlerMap.get(method).invoke(args);
    } catch (Throwable t) {
        // 触发 fallback 或 fallbackFactory
        return handleFallback(t);
    } finally {
        if (entry != null) {
            entry.exit();
        }
    }
}

3. 调用链和降级触发流程

rust 复制代码

FeignClient -> SentinelInvocationHandler -> SphU.entry()
    ├── 正常调用远程服务
    ├── 异常 / 超时 / Sentinel 规则拦截
    │       └── 调用 fallback / fallbackFactory

触发降级的几种情况：

Sentinel 规则触发
- 限流（FlowRule）
- 熔断（DegradeRule）
- 系统保护（SystemRule）
  一旦 SphU.entry() 抛出 BlockException，立即走降级逻辑。
远程调用异常
- 连接失败
- 超时异常
- HTTP 5xx 错误
- 这些异常会被捕获，并进入 fallback。

4. Fallback 与 FallbackFactory

4.1 Fallback

你可以在 @FeignClient 里直接指定降级类：

less 复制代码

@FeignClient(name = "order-service", fallback = OrderFeignFallback.class)
public interface OrderFeignClient {
    @GetMapping("/order/{id}")
    Order getOrder(@PathVariable Long id);
}

@Component
class OrderFeignFallback implements OrderFeignClient {
    @Override
    public Order getOrder(Long id) {
        return new Order(-1L, "降级订单");
    }
}

4.2 FallbackFactory

可以拿到异常信息：

less 复制代码

@FeignClient(name = "order-service", fallbackFactory = OrderFeignFallbackFactory.class)
public interface OrderFeignClient { ... }

@Component
class OrderFeignFallbackFactory implements FallbackFactory<OrderFeignClient> {
    @Override
    public OrderFeignClient create(Throwable cause) {
        return id -> {
            log.error("调用失败: {}", cause.getMessage());
            return new Order(-1L, "降级订单");
        };
    }
}

5. 关键点总结

feign.sentinel.enable=true 会让 Feign 使用 SentinelFeign.Builder。
核心是 SphU.entry() 拦截调用，把 Feign 请求当作一个 Sentinel 受保护的资源。
异常来源既可能是 Sentinel 拦截 ，也可能是 调用本身失败。
降级逻辑是通过 fallback 或 fallbackFactory 注入的。
本质上是 动态代理 + Sentinel Resource 拦截 的结合。

Sentinel + Feign 降级时序图

好，那我给你画一个 Feign + Sentinel 降级原理时序图，让整个调用链一目了然。

Feign + Sentinel 降级流程时序图

rust 复制代码

sequenceDiagram
    participant Controller as 调用方Controller
    participant FeignClient as Feign接口代理
    participant SentinelHandler as SentinelInvocationHandler
    participant Sentinel as Sentinel资源保护
    participant RemoteService as 远程服务
    participant Fallback as 降级实现类

    Controller ->> FeignClient: 调用Feign方法
    FeignClient ->> SentinelHandler: 动态代理拦截
    SentinelHandler ->> Sentinel: SphU.entry(resourceName)
    alt 规则未触发
        SentinelHandler ->> RemoteService: 发起HTTP请求
        alt 调用成功
            RemoteService -->> SentinelHandler: 返回结果
            SentinelHandler -->> Controller: 正常返回
        else 调用异常
            SentinelHandler ->> Fallback: 调用降级方法
            Fallback -->> Controller: 返回降级结果
        end
    else 规则触发 (限流/熔断等)
        Sentinel -->> SentinelHandler: 抛出BlockException
        SentinelHandler ->> Fallback: 调用降级方法
        Fallback -->> Controller: 返回降级结果
    end

图解要点

动态代理替换
- feign.sentinel.enable=true 会让 Feign 用 SentinelFeign.Builder 构建代理。
- 方法调用先进入 SentinelInvocationHandler，而不是直接发请求。
Sentinel 资源保护
- 调用前通过 SphU.entry() 申请资源。
- 如果触发限流/熔断等规则，会直接抛 BlockException，不走远程调用。
降级执行
- 无论是 Sentinel 拦截还是远程调用异常，都会进入 fallback 或 fallbackFactory。
- 降级类返回兜底数据，保证调用方不感知服务故障细节。

Feign + Sentinel 降级的内部类结构图