SpringCloud Alibaba Sentinel 从入门到精通

更新时间：2026年04月29日 09:04:41 作者：tsyjjOvO

本文介绍了Sentinel的核心概念、使用方式及规则配置,Sentinel是阿里巴巴开源的流量控制框架,主要应用于流量控制、熔断降级等场景,文中有详细的规则配置示例,并介绍了如何与Feign整合,感兴趣的朋友一起看看吧

前言

在微服务架构中，服务间的依赖关系复杂，一个服务的故障可能引发连锁反应，导致整个系统雪崩。Sentinel 作为阿里巴巴开源的流量控制框架，能从流量控制、熔断降级等维度保护服务稳定性。本文将从实战角度，完整讲解 Sentinel 的核心概念、使用方式及各类规则配置。

一、Sentinel 核心概念

1.1 什么是 Sentinel

Sentinel（分布式系统的流量防卫兵）以流量为切入点，提供流量控制、熔断降级、系统负载保护等能力，保障微服务高可用。

1.2 核心概念

资源：Sentinel 要保护的对象，可是一个接口、方法、服务等。
规则：定义保护资源的策略，包括流量控制、熔断降级、热点参数、系统规则、授权规则等。
核心功能：
- 流量控制：限制接口 QPS / 线程数，避免服务被压垮。
- 熔断降级：当下游服务异常时，暂时切断调用，防止级联故障。

二、环境准备

2.1 搭建基础微服务

2.1.1 服务提供者（sentinel-provider）

application.yml

server:
  port: 9090
spring:
  cloud:
    nacos:
      discovery:
        server-addr: 192.168.209.129:8848
  application:
    name: sentinel-provider

核心服务类

@Service
public class UserServiceImpl implements UserService {
    @Override
    public User getUserById(Integer id) {
        // 模拟网络延时
        try {
            Thread.sleep(2000);
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
        return new User(id,"王粪堆-provider",18);
    }
}

2.1.2 Feign 接口（sentinel_feign）

@FeignClient("sentinel-provider")
public interface UserFeign {
    @RequestMapping(value = "/provider/getUserById/{id}")
    public User getUserById(@PathVariable Integer id);
}

2.1.3 服务消费者（sentinel_consumer）

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>springcloud_parent</artifactId>
        <groupId>com.hg</groupId>
        <version>1.0-SNAPSHOT</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>sentinel_consumer</artifactId>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>com.hg</groupId>
            <artifactId>springcloud_common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
        </dependency>
        <!--feign接口-->
        <dependency>
            <groupId>com.hg</groupId>
            <artifactId>sentinel_feign</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <!--Sentinel核心依赖-->
        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-sentinel</artifactId>
        </dependency>
    </dependencies>
</project>

application.yml

server:
  port: 8080
  tomcat:
    max-threads: 10 # 降低tomcat并发，便于测试雪崩
spring:
  cloud:
    nacos:
      discovery:
        server-addr: 192.168.209.129:8848
    sentinel:
      transport:
        dashboard: 127.0.0.1:8080 # Sentinel控制台地址
feign:
  client:
    config:
      default:
        connectionTimeout: 5000
        readTimeout: 5000
  sentinel:
    enabled: true # 开启Feign整合Sentinel

三、Sentinel 快速入门

3.1 方式 1：硬编码（抛异常方式）

@RestController
@RequestMapping("/consumer")
public class ConsumerController {
    @RequestMapping(value = "/hello")
    public String hello() {
        Entry entry = null;
        try {
            // 定义资源
            entry = SphU.entry("/consumer/hello");
            return "Hello Sentinel！！！";
        } catch (BlockException e) {
            // 限流兜底逻辑
            return "接口被限流了, exception: " + e;
        }finally {
            if (entry != null) {
                entry.exit();
            }
        }
    }
    // 初始化限流规则
    @PostConstruct
    public void initFlowQpsRule() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule1 = new FlowRule();
        rule1.setResource("/consumer/hello"); // 资源名
        rule1.setGrade(RuleConstant.FLOW_GRADE_QPS); // 按QPS限流
        rule1.setCount(2); // QPS阈值2
        rules.add(rule1);
        FlowRuleManager.loadRules(rules);
    }
}

3.2 方式 2：注解方式（推荐）

@RestController
@RequestMapping("/consumer")
public class ConsumerController {
    // 开启Sentinel注解支持
    @Bean
    public SentinelResourceAspect sentinelResourceAspect(){
        return new SentinelResourceAspect();
    }
    @RequestMapping(value = "/hello2")
    @SentinelResource(value="/consumer/hello2",blockHandler = "blockHandlerMethod")
    public String hello2() {
        return "Hello Sentinel2！！！";
    }
    // 限流兜底方法
    public String blockHandlerMethod(BlockException e){
        return "接口被限流了, exception: " + e;
    }
    @PostConstruct
    public void initFlowQpsRule() {
        List<FlowRule> rules = new ArrayList<>();
        FlowRule rule1 = new FlowRule();
        rule1.setResource("/consumer/hello2");
        rule1.setGrade(RuleConstant.FLOW_GRADE_QPS);
        rule1.setCount(2);
        rules.add(rule1);
        FlowRuleManager.loadRules(rules);
    }
}

3.3 Sentinel 控制台使用

3.3.1 启动控制台

# 下载地址：https://github.com/alibaba/Sentinel/releases
java -jar sentinel-dashboard-1.8.1.jar

访问 http://localhost:8080，默认账号 / 密码：sentinel/sentinel。

3.3.2 接入控制台

消费者配置文件中添加：

spring:
  cloud:
    sentinel:
      transport:
        dashboard: 127.0.0.1:8080

访问任意接口（如 http://127.0.0.1:8080/consumer/hello3），控制台即可识别服务。

四、Sentinel 核心规则配置

4.1 流量控制规则

流量控制是 Sentinel 最核心的功能，通过限制 QPS / 线程数，防止服务被压垮。

4.1.1 核心配置项说明

配置项	说明
资源名	唯一标识，默认请求路径
针对来源	限制调用方（默认 default，不区分来源）
阈值类型	QPS（每秒请求数）/ 线程数
流控模式	直接（限流当前接口）/ 关联（关联接口阈值触发限流）/ 链路（指定入口限流）
流控效果	快速失败 / Warm Up（预热）/ 排队等待

4.1.2 典型场景配置

（1）QPS 限流

规则配置：资源名 /consumer/getUserById/{id}，阈值类型 QPS，单机阈值 2；
效果：接口 QPS 超过 2 时，直接触发限流。

（2）Warm Up（预热限流）

适用场景：流量突增（如秒杀），避免瞬间打满服务；
规则配置：阈值类型 QPS，单机阈值 6，预热时长 5 秒；
效果：QPS 从 2（6/3）开始，5 秒后升至 6，平滑提升流量处理能力。

（3）排队等待

适用场景：需要匀速处理请求（如削峰填谷）；
规则配置：阈值类型 QPS，单机阈值 1，排队超时时间 10ms；
效果：请求匀速通过，超时未处理的请求直接丢弃。

4.2 热点参数限流

对接口参数做精细化限流，支持参数例外项（如特定 ID 放宽阈值）。

@RequestMapping(value = "/getUserById/{id}")
@SentinelResource(value = "getUserById", blockHandler = "blockHandlerMethod")
public User getUserById(@PathVariable Integer id) {
    return userFeign.getUserById(id);
}
// 热点参数限流兜底方法
public User blockHandlerMethod(Integer id, BlockException e) {
    return new User(id, "热点参数限流触发", 0);
}

规则配置：资源名 getUserById，参数索引 0（第一个参数），单机阈值 2；
例外项配置：参数值 2，阈值 3（ID=2 时 QPS 阈值提升至 3）。

4.3 熔断降级规则

当接口响应慢 / 异常比例高时，暂时切断调用，避免级联故障。

4.3.1 三种熔断策略

策略	触发条件
慢调用比例	慢调用（RT 超过阈值）占比超过设定值，且请求数≥最小请求数
异常比例	异常请求占比超过设定值，且请求数≥最小请求数
异常数	异常请求数超过设定值，且请求数≥最小请求数

4.3.2 配置示例（慢调用比例）

规则配置：资源名 /consumer/getUserById/{id}，最大 RT 200ms，比例阈值 0.5，熔断时长 5s，最小请求数 5；
效果：5 个请求中若 50% 以上 RT 超过 200ms，触发熔断，5 秒内拒绝所有请求。

4.4 授权规则

基于请求来源做黑白名单控制，适合接口访问权限管控。

4.4.1 实现来源解析

@Component
public class RequestOriginParserDefinition implements RequestOriginParser {
    @Override
    public String parseOrigin(HttpServletRequest request) {
        // 从请求参数获取来源标识（可替换为请求头、Session等）
        return request.getParameter("origin");
    }
}

4.4.2 规则配置

黑名单：资源名 /consumer/getUserById/{id}，黑名单值 app1；
效果：来源为 app1 的请求直接被拒绝。

4.5 系统规则

针对整个应用的全局规则（粒度粗，慎用），支持：

LOAD（Linux 系统负载）；
RT（所有请求平均响应时间）；
线程数（所有请求总线程数）；
入口 QPS（所有接口总 QPS）；
CPU 使用率。

五、Sentinel 高级特性

5.1 自定义兜底逻辑（blockHandler）

5.1.1 同级别兜底（当前类）

@SentinelResource(value = "getUserById", blockHandler = "blockHandlerMethod")
public User getUserById(@PathVariable Integer id) {
    return userFeign.getUserById(id);
}
// 兜底方法（参数与原方法一致，最后加BlockException）
public User blockHandlerMethod(Integer id, BlockException e) {
    return new User(0, "接口被流控/熔断："+e, 0);
}

5.1.2 外置兜底类（解耦）

// 外置兜底类（方法必须static）
public class BlockHandlerClass {
    public static User blockHandlerMethod(Integer id, BlockException e) {
        return new User(0, "外置兜底："+e, 0);
    }
}
// 使用外置兜底类
@SentinelResource(value = "getUserById",
        blockHandler = "blockHandlerMethod",
        blockHandlerClass = BlockHandlerClass.class)
public User getUserById(@PathVariable Integer id) {
    return userFeign.getUserById(id);
}

5.2 全局异常处理

统一处理 Sentinel 各类异常，返回标准化响应。

@Component
public class GlobalBlockExceptionHandler implements BlockExceptionHandler {
    @Override
    public void handle(HttpServletRequest request, HttpServletResponse response, BlockException e) throws Exception {
        response.setContentType("application/json;charset=utf-8");
        Result data = null;
        if (e instanceof FlowException) {
            data = new Result(-1, "限流异常");
        } else if (e instanceof DegradeException) {
            data = new Result(-2, "降级异常");
        } else if (e instanceof ParamFlowException) {
            data = new Result(-3, "参数限流异常");
        } else if (e instanceof AuthorityException) {
            data = new Result(-4, "授权异常");
        } else if (e instanceof SystemBlockException) {
            data = new Result(-5, "系统负载异常");
        }
        response.getWriter().write(JSON.toJSONString(data));
    }
}
// 统一返回体
class Result {
    private int status;
    private String msg;
    private Object data;
    // 省略getter/setter/构造器
}

5.3 Sentinel 整合 Feign

实现 Feign 远程调用的熔断降级，避免下游服务异常影响上游。

5.3.1 实现 FallbackFactory

@Component
public class UserFeignFallback implements FallbackFactory<UserFeign> {
    @Override
    public UserFeign create(Throwable t) {
        return new UserFeign() {
            @Override
            public User getUserById(Integer id) {
                return new User(id, "Feign调用失败："+t, 0);
            }
        };
    }
}

5.3.2 配置 Feign 接口

@FeignClient(value = "sentinel-provider", fallbackFactory = UserFeignFallback.class)
public interface UserFeign {
    @RequestMapping(value = "/provider/getUserById/{id}")
    User getUserById(@PathVariable Integer id);
}

六、总结

Sentinel 凭借轻量、易用、灵活的特性，成为 SpringCloud 微服务架构中服务保护的首选方案。核心要点总结：

资源定义：通过硬编码 / 注解 / 自动适配（SpringMVC/Feign）定义受保护资源；
规则配置：控制台 / 代码配置流量控制、熔断降级等规则，按需选择粒度；
兜底逻辑：通过 blockHandler / 全局异常 / FallbackFactory 处理限流 / 熔断场景；
核心价值：从流量入口到服务调用全链路保护，防止雪崩效应，保障微服务高可用。

建议结合 JMeter 压测工具验证各类规则效果，加深对 Sentinel 流量控制、熔断降级的理解，根据业务场景灵活配置规则，平衡系统稳定性和可用性。

到此这篇关于SpringCloud Alibaba Sentinel 从入门到精通的文章就介绍到这了,更多相关SpringCloud Alibaba Sentinel 使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java中的移位运算符使用及原理详解
在 Java 中,移位运算符用于对二进制数进行位移操作,它们可以将一个数的所有位向左或向右移动指定的位数,本文小编将给大家详细的介绍一下Java移位运算符,需要的朋友可以参考下
2023-09-09
Java基础篇_有关接口和抽象类的几道练习题(分享)
下面小编就为大家带来一篇Java基础篇_有关接口和抽象类的几道练习题(分享)。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-06-06
在IDEA中创建父工程和子模块module的方法步骤
这篇文章主要介绍了在IDEA中创建父工程和子模块module的方法步骤，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-02-02
带你了解JAVA中的一些锁概念
今天小编就为大家分享一篇关于Java分布式锁的概念与实现方式详解，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2021-08-08
spring boot+redis 监听过期Key的操作方法
这篇文章主要介绍了spring boot+redis 监听过期Key,本文通过示例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-08-08
Springboot整合Shiro实现登录与权限校验详细解读
本文给大家介绍Springboot整合Shiro的基本使用，Apache Shiro是Java的一个安全框架，Shiro本身无法知道所持有令牌的用户是否合法，我们将整合Shiro实现登录与权限的验证
2022-04-04
JAVA Reactor中Sinks.Many类三种常见的创建方式及使用
Sinks.Many用于创建多值(Multi-Value)的发布者(Publisher)的一种机制,它允许用户将数据从一个地方发送到多个订阅者,这篇文章主要介绍了JAVA Reactor中Sinks.Many类三种常见的创建方式及使用,需要的朋友可以参考下
2025-07-07
Springboot内置Tomcat配置参数调优方式
这篇文章主要介绍了Springboot内置Tomcat配置参数调优方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-06-06
spring注解如何为bean指定InitMethod和DestroyMethod
这篇文章主要介绍了spring注解如何为bean指定InitMethod和DestroyMethod，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2021-11-11
Springboot结合Flowable实现工作流开发
本文主要介绍了Springboot结合Flowable实现工作流开发，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-01-01