在微服务架构中，服务之间的调用错综复杂，一旦某个服务出现故障或响应缓慢，很容易引发“雪崩效应”——整个系统瘫痪。如何在服务调用链中实现熔断（Circuit Breaker）和限流（Rate Limiting）？

Sentinel 作为阿里巴巴开源的流量治理组件，配合 OpenFeign，可以轻松实现微服务调用的熔断与降级。本文将手把手带你完成一次完整的实战集成。

一、为什么选择 Sentinel + OpenFeign？

二、项目准备

技术栈

Spring Boot 3.x（或 2.7.x）
Spring Cloud 2022.x（或 2021.x）
Spring Cloud Alibaba 2022.x（或 2021.x）
Nacos（服务注册与配置中心）
Sentinel Dashboard（1.8.6+）

服务规划

user-service：用户服务（被调用方）
order-service：订单服务（调用方，集成 Feign + Sentinel）

三、搭建基础服务

1. 启动 Nacos 与 Sentinel Dashboard

java -Dserver.port=8080 -Dcsp.sentinel.dashboard.server=localhost:8080 -jar sentinel-dashboard.jar

2. user-service（被调用方）

@RestController
public class UserController {
   
    @GetMapping("/users/{id}")
    public User getUserById(@PathVariable Long id) {
   
        if (id == 999) {
   
            throw new RuntimeException("模拟服务异常");
        }
        return new User(id, "User-" + id);
    }
}

注册到 Nacos：

# application.yml
spring:
  application:
    name: user-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848

四、在 order-service 中集成 OpenFeign + Sentinel

1. 添加依赖（Maven）

<!-- OpenFeign -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

<!-- Sentinel -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>

<!-- Sentinel Feign 支持 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-alibaba-sentinel-feign</artifactId>
</dependency>

<!-- Nacos Discovery -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2. 启用 Feign 与 Sentinel

@SpringBootApplication
@EnableFeignClients
public class OrderServiceApplication {
   
    public static void main(String[] args) {
   
        SpringApplication.run(OrderServiceApplication.class, args);
    }
}

3. 配置 application.yml

spring:
  application:
    name: order-service
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848
    sentinel:
      transport:
        dashboard: localhost:8080  # 连接 Sentinel Dashboard
        port: 8719                 # 本地通信端口（默认）

# 开启 Feign 对 Sentinel 的支持
feign:
  sentinel:
    enabled: true

4. 定义 Feign 客户端（带 fallback）

@FeignClient(name = "user-service", fallback = UserClientFallback.class)
public interface UserClient {
   
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
}

@Component
public class UserClientFallback implements UserClient {
   
    @Override
    public User getUserById(Long id) {
   
        return new User(-1L, "【降级返回】用户服务暂时不可用");
    }
}

5. 业务调用

@RestController
public class OrderController {
   

    @Autowired
    private UserClient userClient;

    @GetMapping("/orders/user/{id}")
    public String getOrderWithUser(@PathVariable Long id) {
   
        User user = userClient.getUserById(id);
        return "订单创建成功，用户：" + user.getName();
    }
}

五、验证熔断与限流效果

场景1：服务异常触发熔断

启动 user-service 和 order-service
访问：http://localhost:8081/orders/user/999（假设 order-service 端口为 8081）
第一次调用会抛出异常（因为 user-service 抛异常）
连续多次调用后（默认 5 次异常），Sentinel 会自动熔断
后续请求直接走 fallback，返回降级数据

场景2：通过 Dashboard 配置限流

访问 http://localhost:8080（Sentinel Dashboard）
首次访问需先触发一次 Feign 调用（如访问 /orders/user/1），才能在 Dashboard 中看到资源
在左侧菜单找到资源：GET:http://user-service/users/{
   id}
点击「流控」→ 添加流控规则：
QPS 单机阈值：1
流控模式：直接
快速刷新页面，超过 1 次/秒的请求将被限流，返回 Blocked by Sentinel (flow limiting)

六、高级技巧：自定义 BlockHandler（限流兜底）

@FeignClient(
    name = "user-service",
    fallback = UserClientFallback.class,
    configuration = FeignConfig.class
)
public interface UserClient {
   
    @GetMapping("/users/{id}")
    User getUserById(@PathVariable("id") Long id);
}

// 自定义配置类
public class FeignConfig {
   
    @Bean
    public BlockRequestHandler blockRequestHandler() {
   
        return (request, ex) -> {
   
            // 返回 JSON 格式的限流提示
            Map<String, Object> result = new HashMap<>();
            result.put("code", 429);
            result.put("msg", "请求太频繁，请稍后再试");
            return ResponseEntity.status(429).body(result);
        };
    }
}

七、最佳实践建议

熔断规则合理配置：避免过于敏感（频繁误熔断）或过于迟钝（起不到保护作用）
降级逻辑轻量：fallback 方法不要包含复杂逻辑或远程调用
监控告警：结合 Sentinel Dashboard + Prometheus + Grafana 实现告警
规则持久化：默认规则在应用重启后丢失，建议接入 Nacos/Apollo 持久化规则
测试验证：通过 Chaos Engineering（如 ChaosBlade）模拟故障，验证熔断效果

八、总结

通过 OpenFeign + Sentinel 的组合，我们以极低的代码侵入性，实现了：

✅ 服务异常时自动熔断降级
✅ 高并发下自动限流保护
✅ 可视化监控与动态规则调整
这正是微服务高可用架构的核心能力之一。