Spring Boot 集成 Sentinel 实现限流与熔断需三层协同：连接控制台实现可视化管理，配置规则引擎设定QPS限流与慢调用熔断策略，绑定@SentinelResource资源并定义fallback/blockHandler处理降级。
Spring Boot 中配置 Sentinel 实现接口限流与熔断降级，关键不在堆注解，而在三层协同：接入控制台看清流量、配置规则引擎定好策略、绑定业务资源守住边界。网关层做粗粒度拦截，服务层做细粒度控制+熔断兜底，才能应对真实洪峰。
部署并连接 Sentinel 控制台
控制台是规则可视化和动态管理的基础，不依赖它也能运行限流逻辑，但失去实时调整和监控能力。
- 下载最新版 sentinel-dashboard-x.x.x.jar（推荐 1.8.6 或更高），执行命令启动：
java -Dserver.port=8080 -Dcsp.sentinel.dashboard.server=localhost:8080 -jar sentinel-dashboard-1.8.6.jar
- 访问 http://localhost:8080，默认账号密码均为 sentinel
- 在 Spring Boot 项目 application.yml 中配置连接信息：
spring:
cloud:
sentinel:
transport:
dashboard: localhost:8080
eager: true
其中 eager: true 表示启动时立即注册，避免首次请求才触发连接延迟。
添加依赖并启用 Sentinel
确保项目具备 Sentinel 的运行时能力，注意版本兼容性（Spring Boot 2.7+/3.x 对应 Spring Cloud Alibaba 2022+/2023+）。
- 在 pom.xml 中引入核心依赖：
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency>
- 无需额外加 @EnableSentinel 注解（新版已自动装配），但需确认主类所在包能被 Spring 扫描到
- 若使用 Feign 调用下游服务，建议同时引入：
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alibaba-sentinel-feign</artifactId>
</dependency>
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
定义接口限流规则
限流针对的是“资源”，可以是 URL 路径、方法名或自定义字符串。规则可代码初始化，也可通过控制台动态配置。
- 在 Controller 方法上标注资源名，保持与规则一致：
@GetMapping("/order/create")
@SentinelResource(value = "order_create_api", fallback = "createFallback")
public Result createOrder(@RequestBody OrderReq req) { ... }
- 编写 fallback 方法处理被限流场景：
public Result createFallback(OrderReq req, BlockException ex) {
return Result.fail("当前请求繁忙，请稍后再试");
}
- 初始化 QPS 限流规则（例如每秒最多 50 次）：
@PostConstruct
public void initFlowRules() {
List<FlowRule> rules = new ArrayList<>();
FlowRule rule = new FlowRule("order_create_api")
.setCount(50)
.setGrade(RuleConstant.FLOW_GRADE_QPS)
.setControlBehavior(RuleConstant.CONTROL_BEHAVIOR_DEFAULT); // 直接拒绝
rules.add(rule);
FlowRuleManager.loadRules(rules);
}
配置熔断降级规则
熔断保护的是调用链稳定性，适用于依赖外部服务（如数据库、第三方 API）响应慢或失败率高的场景。
- 在业务方法中同样用 @SentinelResource 标记，并指定 blockHandler 或 fallback：
@SentinelResource(value = "user_info_api",
fallback = "getUserFallback",
blockHandler = "handleBlock")
public User getUser(Long id) { return userService.getById(id); }
- 初始化熔断规则（例如慢调用比例 ≥ 50%，平均响应超 1000ms，持续 10 秒即熔断）：
private void initDegradeRules() {
List<DegradeRule> rules = new ArrayList<>();
DegradeRule rule = new DegradeRule("user_info_api")
.setGrade(RuleConstant.DEGRADE_GRADE_RT) // 慢调用熔断
.setCount(1000) // RT 阈值 ms
.setTimeWindow(10) // 熔断持续时间（秒）
.setMinRequestAmount(5) // 最小请求数
.setStatIntervalMs(60 * 1000) // 统计窗口（毫秒）
.setSlowRatioThreshold(0.5); // 慢调用比例阈值
rules.add(rule);
DegradeRuleManager.loadRules(rules);
}
熔断触发后，后续请求会直接走 blockHandler；若希望返回兜底数据，用 fallback 更合适。
