当前位置：首页 > news >正文

Sentinel 流控规则 · 流控效果

news 2026/8/15 8:54:01

文章目录

Sentinel 流控规则 · 流控效果
- 一、依赖与接入
- 二、流控效果是什么
- 三、阈值类型：QPS vs 并发线程数
- 四、控制台参数字段（完整）
- - 流控效果 × 阈值类型
- 五、三种效果详解
- - 5.1 快速失败（默认）
  - 5.2 Warm Up 预热
  - 5.3 匀速排队
- 六、JSON 规则片段
- 参考官方文档

Sentinel 流控规则 · 流控效果

基于spring-cloud-demo· order-service · Boot 4.1.0 + Cloud 2025.1.2

一、依赖与接入

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

spring:cloud:sentinel:transport:dashboard:127.0.0.1:8100# 控制台地址

启动 Dashboard
这里的指令是8100作为控制台端口号
账号:admin
密码:admin

java-Dserver.port=8100-Dsentinel.dashboard.auth.username=admin-Dsentinel.dashboard.auth.password=admin-Dserver.servlet.session.timeout=1440m-jarsentinel-dashboard-1.8.10.jar

二、流控效果是什么

流控效果（controlBehavior）决定超过阈值后怎么处理请求。

效果	controlBehavior	适用阈值类型
快速失败	0	QPS和并发线程数
Warm Up 预热	1	仅 QPS
匀速排队	2	仅 QPS

三、阈值类型：QPS vs 并发线程数

类型	grade	限制什么
QPS	1	滑动窗口约 1 秒内通过次数
并发线程数	0	同时正在处理的请求数

近似关系：QPS ≈ 并发数 / 平均响应时间(秒)。

并发线程数: 当设置阈值为5,有五个任务正在执行,第六个任务来临时丢弃

四、控制台参数字段（完整）

控制台字段	JSON 字段	说明
阈值类型	grade	0=线程数，1=QPS
流控效果	controlBehavior	0快速失败，1预热，2匀速排队
单机阈值	count	阈值数值
预热时长	warmUpPeriodSec	秒，仅预热
排队超时	maxQueueingTimeMs	毫秒，仅匀速排队
冷启动因子	coldFactor	默认 3，仅预热

流控效果 × 阈值类型

QPS	并发线程数
快速失败	✅	✅
Warm Up	✅	❌
匀速排队	✅	❌

五、三种效果详解

5.1 快速失败（默认）

超限后立即拒绝，抛出FlowException
并发线程数=5：第 6 个请求立刻 Block，不排队

5.2 Warm Up 预热

当有大量数据进入时,缓慢接收少量逐渐递增,超过时间后,超出阈值的丢弃. 适合开机冷启动
适合缓存、连接池未就绪的场景

5.3 匀速排队

按 QPS 均匀放行，超限请求排队等待
超过maxQueueingTimeMs仍排不上则失败

六、JSON 规则片段

完整持久化见 sentinel-规则持久化.md。

[{"resource":"order-service-print","limitApp":"default","grade":1,"count":5,"strategy":0,"controlBehavior":0,"warmUpPeriodSec":10,"maxQueueingTimeMs":500,"clusterMode":false}]

JSON 字段	说明
controlBehavior	0/1/2 对应三种效果
warmUpPeriodSec	预热时长，controlBehavior=1 时有效
maxQueueingTimeMs	排队超时，controlBehavior=2 时有效