Sentinel 是 Alibaba 开源的轻量级流量控制组件，支持限流、降级、系统保护和热点参数限流；需引入 spring-cloud-starter-alibaba-sentinel 依赖，配置 dashboard 地址，通过 @SentinelResource 注解或 SphU.entry 定义资源，控制台动态配置规则，并可整合 Feign 实现远程调用限流与降级。
在 Java 微服务项目中，Sentinel 是阿里巴巴开源的轻量级流量控制组件，能有效实现限流、降级、系统保护和热点参数限流。它不依赖外部中间件，接入简单，控制台可视化，适合 Spring Cloud Alibaba 生态。
引入依赖与基础配置
以 Spring Boot + Spring Cloud Alibaba 为例，需添加 Sentinel 核心依赖和适配器：
- 在 pom.xml 中加入：
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
</dependency> - 配置 application.yml 指向 Sentinel 控制台（默认端口 8080）：
spring:
cloud:
sentinel:
transport:
dashboard: localhost:8080 - 启动 Sentinel 控制台（下载 jar 包后执行
java -jar sentinel-dashboard.jar），服务首次访问任意接口会自动注册到控制台
定义资源并配置限流规则
限流围绕“资源”展开，可使用注解或 API 方式定义资源：
-
@SentinelResource 注解最常用，标注在方法上，指定资源名（如
value = "getUser"）
配合blockHandler指定被限流时的兜底方法（需为 static 方法，参数与原方法一致，加 Throwable） - 也可用
SphU.entry("resourceName")手动埋点，配合 try-catch 实现更细粒度控制 - 规则可在控制台动态配置：选择簇点链路 → 点击对应资源 → 新增流控规则
设置 QPS 阈值、流控模式（直接/关联/链路）、流控效果（快速失败/Warm Up/排队等待）
实现熔断降级策略
降级用于应对下游不稳定（如慢调用、异常率高），避免雪崩：
立即学习“Java免费学习笔记（深入）”；
- 在控制台「降级规则」页新增规则，选择目标资源，设置：
• RT（平均响应时间）：例如 500ms 超过阈值且持续 5 秒，触发降级，接下来 10 秒内请求直接走降级逻辑
• 异常比例/异常数：适用于服务调用频繁出错的场景 - 代码中同样通过
@SentinelResource(fallback = "fallbackMethod")定义降级后的处理方法
注意：fallback处理业务异常（如 RuntimeException），blockHandler处理限流/降级等 Sentinel 自身异常
整合 Feign 远程调用限流
Feign 默认不自动识别 Sentinel，需开启适配：
- 在 application.yml 中启用：
feign:
sentinel:
enabled: true - Feign 接口方法会被自动识别为资源，资源名为
GET:https://service-name/path类似格式
可在控制台按 URL 路径配置限流或降级规则 - 建议自定义 fallback 类实现降级逻辑，并在
@FeignClient中声明：
@FeignClient(name = "user-service", fallback = UserFallback.class)
注意事项与最佳实践
实际落地中容易忽略的关键点：
- 资源名不宜过细（如带动态 ID），否则规则数量爆炸；推荐按接口路径或业务功能维度聚合
- 控制台规则是内存级，重启失效；生产环境建议接入 Nacos 或 Apollo 实现规则持久化
- 注意线程隔离与信号量模式区别：Web 场景多用线程池隔离（防阻塞），内部 RPC 调用可用信号量（开销小）
- 监控指标（如 QPS、响应时间、拒绝数）可通过 /actuator/sentinel 查看，也可对接 Prometheus
