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 中引入核心依赖：

  com.alibaba.cloud
  spring-cloud-starter-alibaba-sentinel

• 无需额外加 @EnableSentinel 注解（新版已自动装配），但需确认主类所在包能被 Spring 扫描到
• 若使用 Feign 调用下游服务，建议同时引入：

  com.alibaba.cloud
  spring-cloud-alibaba-sentinel-feign

Alibabacloud Sdk Client Initialization For Java

在 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 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 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 更合适。