一、Sentinel 流控规则基本介绍

1、Snetinel 流控规则配置方式

Sentinel 支持可视化的流控规则配置，使用非常简单；可以在监控服务下的“簇点链路” 或

“流控规则” 中给指定的请求资源配置流控规则；一般推荐在 “簇点链路” 中配置流控规则。

如下图所示：

1）在 “簇点链路” 中配置流控规则

2）在 “流控规则” 中配置流控规则

2、流控规则名词解析

1）资源名：唯一名称，默认请求路径

2）针对来源：Sentinel可以针对调用者进行限流，填写微服务名，默认default（不区分来源）

3）阈值类型：

QPS：每秒钟的请求数量，当调用该API的QPS达到阈值的时候，进行限流

并发请求数：每秒调用请求的线程数量，当调用该API的线程数量达到阈值的时候，

进行限流

4）单机阈值：指每秒调用当前资源的次数

5）是否集群：当前不需要集群，先不测试集群

6）流控模式：

I）直接：API达到限流条件时，直接限流

II）关联：当关联的资源达到阈值时，就限流自己

III）链路：只记录指定链路上的流量（指定资源从入口资源进来的流量，如果达到阈值，

就进行限流）(API级别的针对来源)

7）流控效果：

I）直接失败：直接失败，抛出异常

II）Wam Up：根据codeFactor（冷加载因子，默认3）的值，从“阈值/codeFacotor” 开始，

经过预热时长，才达到设置的QPS阈值

III）排队等待：匀速排队，让请求以匀速的速度通过，阈值类型必须设置为QPS，否则无效

二、具体的流控规则配置练习

1、准备环境

创建服务（sentinel-8401），并整合Sentinel（具体步骤请参考上一篇“整合Sentinel”）;

在 sentinel-8401，创建controller类 FlowlimitController，定义2个资源 “/testA”、“/testB”；

如下所示：

@RestController
public class FlowlimitController {@GetMapping("/testA")public String testA() {return "testA------测试";}@GetMapping("/testB")public String testB(){return "testB------测试";}}

1、直接

1.1、QPS（阈值类型）+直接（流控模式）

给请求testA配置流控，阈值类型选择 “QPS”，单机阈值配置为 1，流控模式选择“直接”，

流控效果选择“直接失败”表示当请求/testA每秒请求数超过1时，请求直接失败；

如下图所示：

然后在浏览器或PostMan 中快速访问 “/testA”，当达到限流上限后的请求直接返回异常，

如下所示：

流控模式为 “直接” 、流控效果为“直接”失败的方式很简单，就测试一种情况就行了

2、关联

官方解释：当关联的资源达到阈值时，就限流自己。

通俗解释来说，比如那我们的程序，现在有testA接口和testB接口，当A关联的资源B达到

阈值后，就限流自己，也就是B到达阈值，限流A本身，B本身不会被限流。

换到程序里面来说比如一个电商系统中，支付系统达到阈值，就限流下订单系统。

如下图所示：

2.1、“关联”使用步骤

1）准备2个请求资源“testA接口和testB接口”，如下所示：

@RestController
public class FlowlimitController {@GetMapping("/testA")public String testA() {return "testA------测试";}@GetMapping("/testB")public String testB(){return "testB------测试";}
}

2）给请求资源 “testA” 添加流控规则，testA 关联 testB，并配置testB的QPS为1

如下所示：

3）测试

先在浏览器或postman访问testB，达到限流上限，然后再访问testA，

testA 也会被限流，直接返回失败；

注意：此时testB并没有被限流，testB还能正常访问

3、链路

链路流控模式指的是，当从某个接口过来的资源达到限流条件时，开启限流，它的功能有

点类似于“针对来源”配置项，区别在于：针对来源是针对上级微服务，而链路流控是针对

上级接口，也就是说它的粒度更细。

比如在一个微服务中，两个接口都调用了同一个Service中的方法，并且该方法用

SentinelResource（用于定义资源）注解标注了，然后对该注解标注的资源（方法）进

行配置，则可以选择链路模式。如下图所示：

此时若访问testA时史资源 common 达到了限流上限，再访问testA时会直接抛出异常

（testA被限流了），但此时testB 正常访问，testB没有被限流。

3.2、测试步骤

1）准备service接口common

public interface SentinelService {String common();
}/*****************************************************  测试 Sentinel 流控规则--链路*  链路流控模式指的是，当从某个接口过来的资源达到限流条件时，开启限流，它的功能有点类似于针对来源配置项，*  与来源项的区别在于：来源项针对来源是针对上级微服务，而链路流控是针对上级接口，也就是说它的粒度更细。* 比如在一个微服务中，两个接口都调用了同一个Service中的方法，并且该方法用SentinelResource（用于定义资源）注解标注了，* 然后对该注解标注的资源（方法）进行配置，则可以选择链路模式。** @author * @date 2025/6/23 10:29****************************************************/
@Service
public class SentinelServiceImpl implements SentinelService {/*** 注解 @SentinelResource 指定需要限流的资源（方法）* @return*/@SentinelResource("common")@Overridepublic String common() {return "common";}
}

2）修改FlowlimitController 中的testA 与testB 方法，并调用方法common

@RestController
public class FlowlimitController {@Autowiredprivate SentinelService sentinelService;@GetMapping("/testA")public String testA() {return sentinelService.common();}@GetMapping("/testB")public String testB(){return sentinelService.common();}
}

3）给testA 链路中的方法资源common 配置流控规则，如下所示：