知序
返回
保存草稿
发布
H1
H2
H3
1
2
3
Excalidraw 图
AI 写作
AI 优化
目录
输入内容后显示目录
Markdown
# Sentinel 概述与核心概念 > 导读:本文从"服务被上游突发流量打挂、又被下游慢依赖拖死,加机器和调线程池都治标不治本"这个具体痛点出发,把 Sentinel 解决的三类问题(流量控制、熔断降级、系统自适应保护)、它与 Hystrix 的本质差异、资源/规则/Entry 三个核心概念、Slot 责任链的执行顺序与职责、资源调用链路与调用树、以及 `@SentinelResource` 的用法逐项讲透,最后给出生产用法与踩坑。适合已经写过 Spring Boot 业务、想把"高可用"从口号变成可编程规则的同学。 ## 一、先建立全局认知 ### Q:Sentinel 到底解决什么问题? A:结论先行——Sentinel 是阿里巴巴开源的"流量防卫兵"(Flow Sentinel),它把"服务稳定性"拆成三件**可编程**的事:**流量控制(Flow Control)**、**熔断降级(Circuit Breaking & Degradation)**、**系统自适应保护(System Adaptive Protection)**。三者目标一致:当系统已经过载、或某个下游依赖已经不可用时,让系统**有序地拒绝掉一部分请求**,用局部的失败换取整体的存活,而不是全体线程一起陷进等待、最后雪崩。 先把几个术语钉死,后文都按这个定义走: - **流量控制(Flow Control)**:对某个**资源**的访问速率施加限制,超过阈值的请求被快速拒绝或排队,从而保护资源背后的处理能力。 - **熔断降级(Circuit Breaking / Degradation)**:当某个资源的调用**错误率过高或响应过慢**时,自动切断对它的调用一段时间,改为走本地兜底逻辑(降级),避免把调用方线程耗死。 - **系统自适应保护(System Adaptive Protection)**:从**整个应用进程**的角度设定水位线(如系统负载、CPU 使用率、入口总 QPS),当全局指标越界时,直接拒绝**入口流量**。 - **资源(Resource)**:Sentinel 的**最小保护单元**,可以是一段代码、一个接口、一个方法、甚至一次数据库查询。你保护什么,什么就是资源。 - **规则(Rule)**:作用在资源上的策略配置,如限流规则、熔断规则、系统规则、授权规则、热点参数规则。 - **入口(Entry)**:一次资源调用在 Sentinel 内部留下的"通行证"对象,是统计、规则判断、异常抛出的载体。 三类能力各自解决的痛点并不一样,别混为一谈: | 能力 | 要防的问题 | 触发条件 | 拒绝的对象 | 典型手段 | |------|-----------|---------|-----------|---------| | 流量控制 | 被"太多请求"打挂 | 速率/并发超过阈值 | 超出配额的那部分请求 | QPS 限流、并发线程数限流、热点参数限流 | | 熔断降级 | 被"一个坏依赖"拖死 | 错误比例/慢调用比例越界 | 对该依赖的全部调用 | 自动熔断 + fallback 兜底 | | 系统自适应保护 | 整个进程被压垮 | 全局 load/CPU/RT/线程数越界 | 新的入口请求 | 进程级水位线 + 入口限流 | 一句话区分:**限流管"进来多少",熔断管"还能不能调用下游",系统保护管"整台机器还能不能接活"。** ### Q:Sentinel 和 Hystrix 到底差在哪?为什么现在更推荐 Sentinel? A:结论先行——两者都是"稳定性组件",但**隔离模型与能力边界完全不同**:Hystrix 的核心是"用线程池/信号量把依赖隔离开,再用错误率熔断",天生**不做 QPS 限流**;Sentinel 的核心是"围绕资源的统计 + 规则",**以限流为主业**,熔断是其中一环,并额外提供热点参数限流、集群流控与系统自适应保护。另外 Hystrix 已进入维护模式,不再是活跃演进的项目。 对比表(重要,面试高频): | 维度 | Hystrix | Sentinel | |------|---------|----------| | 隔离方式 | 线程池隔离(默认)/ 信号量隔离,天然带来"舱壁模式" | **没有线程池隔离**,用"并发线程数限流"做轻量隔离 | | 熔断依据 | 基于**错误率**(滑动窗口内失败占比) | 慢调用比例 / 异常比例 / 异常数,可配统计时长与最小请求数 | | 限流能力 | 基本没有 QPS 限流(信号量只限制并发数) | QPS 限流、并发线程数限流、热点参数限流、集群流控 | | 系统自适应保护 | 无 | 有(load1、CPU 使用率、入口 RT、并发线程数、入口 QPS) | | 超时与重试 | 内建命令超时(可中断执行线程) | **不提供超时控制**,需配合 HTTP 客户端 / Feign / 网关等自行设置 | | 使用方式 | 命令模式包裹(`HystrixCommand`),侵入性高 | API(`SphU.entry`)+ 注解(`@SentinelResource`),侵入性低 | | 规则动态性 | 主要依赖配置中心/Archaius | Pull / Push 数据源(Nacos、ZooKeeper、Apollo 等)+ 控制台 | | 监控面板 | Hystrix Dashboard + Turbine | Sentinel 控制台(实时指标 + 在线改规则) | | 维护状态 | Netflix 已进入维护模式,不再加新特性 | 持续演进(主流版本为 1.8.x 系列) | 这里有两个**最容易被记混**的点,单独强调: 1. **线程池隔离 vs 信号量**:Hystrix 的线程池隔离给每个依赖分配独立线程池,好处是"依赖被拖慢也不会占住调用方线程",代价是线程上下文切换与线程数膨胀;Sentinel **不做线程池隔离**,它通过"限制某资源的并发线程数"来达到类似的"不让依赖吃光线程"的效果,但**不提供线程中断/超时**。所以用 Sentinel 时,"超时"必须由调用链上的其他组件负责(例如 Feign 的 connectTimeout/readTimeout、HTTP 客户端超时、网关超时)。 2. **Hystrix 的限流是"顺带"的**:信号量隔离顺带限制了并发数,但它不是按 QPS 精确放行的限流器;Sentinel 的限流才是主业,有明确的阈值类型(QPS/线程数)、流控模式与流控效果。 适用边界:如果你的诉求是"**按 QPS 精确限流 + 动态调规则 + 有控制台**",Sentinel 明显更合适;如果你已经在 Hystrix 体系里并且只关心"依赖隔离 + 错误率熔断",迁移收益主要体现在规则动态化和限流能力上。**不要因为"Sentinel 不支持超时"就否定它——超时本来就不该由限流器来管。** > 注:Hystrix 的具体配置项与默认值随版本变化,若要迁移请以你在用的 Hystrix 版本文档与 Sentinel 官方 Wiki 为准,需结合版本确认。 ### Q:已经有网关限流和 Guava `RateLimiter` 了,为什么还要再加一层 Sentinel? A:结论先行——因为**它们作用的层次与维度不同,无法互相替代**。网关限流是"入口的粗粒度总闸",`RateLimiter` 是"某段代码的速率控制器",两者都只能解决"限流"这一件事;Sentinel 的价值在于**把限流、熔断、系统保护统一到同一套"资源 + 规则"模型下,并能动态调规则、能观测、能兜底**。 分层对比: | 手段 | 作用层 | 能做的事 | 做不到的事 | |------|-------|---------|-----------| | 网关限流 | 最外层入口 | 按 route / API 分组限总 QPS、按调用方来源限流 | 不懂业务语义(不知道哪个 Service 慢、哪个依赖挂了) | | Guava `RateLimiter` / 信号量 | 代码内部(单机) | 单机的速率控制、并发控制 | 无熔断、无系统保护、无动态规则、无可视化 | | Sentinel | 服务入口 + 代码内部 | 限流 + 熔断降级 + 系统自适应保护 + 热点参数 + 集群流控 | **不提供超时**、不做线程池隔离、不做鉴权 | 三个结论: 1. **层次是叠加关系而不是二选一**。网关做入口总闸,Sentinel 在服务内部做细粒度保护,两者职责不冲突;真实系统里往往是"网关限流 + Sentinel + 调用超时"三件套一起上,缺一环都会留下故障面。 2. **Sentinel 不可替代的地方在"动态 + 统一"**:阈值改了不用发版、规则统一按资源名管理、控制台能看到每个资源的实时状况、规则能集中持久化——这些是纯本地组件给不了的。 3. **不要高估 Sentinel 的边界**:它不管超时、不做线程池隔离、不做鉴权。把它定位成"统计 + 规则判断"的基础设施,其他稳定性能力交给对应组件。 适用边界:单体应用、流量极小且长期稳定的内部系统,只用本地 `RateLimiter` 就够,引入 Sentinel 反而增加复杂度与运维成本;但只要"多实例部署 + 需要动态调阈值 + 需要熔断兜底"这三条里占了两条,Sentinel 的投入产出比就很明显。 ### Q:资源、规则、Entry 三者是什么关系? A:结论先行——**资源是"被保护的对象",规则是"保护策略",Entry 是"一次调用进入保护体系的门票"**。调用流程是:`SphU.entry(资源名)` 申请一张 Entry → Sentinel 沿 Slot 链依次检查该资源上的各类规则 → 通过则放行并记录统计,不通过则抛出对应的 `BlockException` → 业务结束后 `entry.exit()` 归还 Entry 并完成耗时统计。 用一张 ASCII 图把三者串起来:  *图:SphU.entry 到 SlotChain 的链路与规则仓库* ```text 业务代码 Sentinel 运行时 ────────────────────────────────────────── SphU.entry("resA") ──────────► ContextUtil:当前调用上下文 Context └── Entry(通行证) │ ▼ SlotChain(责任链,按固定顺序执行) NodeSelector → ClusterBuilder → ... → DegradeSlot │ ├── 规则仓库(各类 RuleManager) │ FlowRuleManager / DegradeRuleManager │ SystemRuleManager / AuthorityRuleManager │ ParamFlowRuleManager │ ├── 通过 → 执行业务 → exit()(回收并发、记账) └── 不通过 → 抛 BlockException(走兜底) 规则(Rule)= 写进 RuleManager 的配置;资源(Resource)= 上图的 "resA" ``` 三个关键结论: - **规则不绑定资源对象,只按资源名匹配**。所以"资源名"是 Sentinel 里最重要的字符串,改名等于换了一套规则(这也是后面常见的坑)。 - **Entry 必须成对使用**:`entry()` 与 `exit()` 要配对,否则统计和并发线程数会算错。用注解或 Spring Cloud Alibaba 的自动适配时,这一步由框架代劳。 - **规则判断发生在"进入资源"的那一刻**,而不是资源执行完之后;熔断的统计则依赖历史调用(StatisticSlot 记录)。 ## 二、理解核心机制 ### Q:一次资源调用在 Sentinel 内部到底经历了什么? A:结论先行——核心就是一条**责任链(ProcessorSlotChain)**。每次 `entry()` 都会拿到当前资源对应的 SlotChain,从链头到链尾依次执行每个 Slot 的逻辑;任何一环抛出 `BlockException`,后面的 Slot 与业务代码就都不会执行。业务执行完之后,`exit()` 会**反向**通知链上的 Slot 完成退出动作(把"正在进行"的计数减回去)。 伪代码级别的流程: ```java // 1. 申请 Entry:进入 Slot 链,逐环检查 Entry entry = null; try { entry = SphU.entry("queryOrder"); // 2. 走到这里说明所有 Slot 都放行 → 执行真正的业务 doBusiness(); } catch (BlockException e) { // 3. 被限流/熔断/系统保护/授权规则拦下,走兜底 handleBlock(e); } finally { if (entry != null) { entry.exit(); // 4. 反向通知 Slot:本次调用结束,回收并发计数并记账 } } ``` 关键点与适用边界: - `SphU.entry(resource)` 用的是**默认的 EntryType.OUT**语义;Web 入口这类"外部请求进来"的场景应使用 `EntryType.IN`,因为**系统规则只对 IN 生效**(这一点非常关键,配了系统规则却不生效,先查这里)。 - 抛出的 `BlockException` 是**受检异常的父类**(准确说是 `BlockException extends Exception`),所以必须 catch 或声明,这也逼着你写兜底逻辑。 - 上面这种"手写 entry/exit"的方式**只在无法用注解时使用**(例如被 Sentinel 不支持的方式调用)。生产上更推荐注解或框架自动适配,避免漏掉 `exit()`。 ### Q:Slot 责任链的默认顺序是什么?每个 Slot 各管什么? A:结论先行——默认(`DefaultSlotChainBuilder`)的顺序是:**NodeSelectorSlot → ClusterBuilderSlot → LogSlot → StatisticSlot → AuthoritySlot → SystemSlot → FlowSlot → DegradeSlot**。顺序不是随便排的:**先建节点、再统计、后判断规则**,而统计必须先于所有规则判断——否则本轮调用的数据就进不了窗口,规则会永远"看旧数据"。  *图:SlotChain 八个 Slot 的顺序与各自职责* ```text 默认 SlotChain(从链头到链尾) ┌──────────────────┐ 1 建"调用来源"节点:这个资源是被哪个上下文调用的 │ NodeSelectorSlot │ → 为本次资源创建/复用 DefaultNode,挂到当前 Context 的调用树上 ├──────────────────┤ 2 建"全局汇聚"节点:同一资源名的所有 DefaultNode 汇聚成一个 ClusterNode │ ClusterBuilderSlot│ → ClusterNode 提供"该资源全局"的统计(跨上下文、跨来源) ├──────────────────┤ 3 记录被拦截(Block)的异常日志 │ LogSlot │ → 命中规则被拦截时打印日志,便于排查"规则为什么生效了" ├──────────────────┤ 4 统计:pass / block / rt / 并发线程数,写进滑动窗口 │ StatisticSlot │ → ★ 必须在规则 Slot 之前,本轮数据要被规则看到 ├──────────────────┤ 5 授权规则:黑白名单 │ AuthoritySlot │ ├──────────────────┤ 6 系统自适应保护:进程级水位线(只对 EntryType.IN 生效) │ SystemSlot │ ├──────────────────┤ 7 流控:QPS / 并发线程数 / 各种流控效果 │ FlowSlot │ ├──────────────────┤ 8 熔断:慢调用比例 / 异常比例 / 异常数 │ DegradeSlot │ └──────────────────┘ ``` 逐个 Slot 的职责(这是"看源码/写扩展"的必备地图): | Slot | 一句话职责 | 关键细节 | |------|-----------|---------| | `NodeSelectorSlot` | 为资源在**当前调用上下文**里创建/复用 `DefaultNode` | 同一资源在不同 Context 下是不同 DefaultNode;默认 Context 名为 `sentinel_default_context`,有数量上限保护 | | `ClusterBuilderSlot` | 把同一资源的 `DefaultNode` 汇聚为 `ClusterNode` | 资源级"全局"统计都在 ClusterNode 上;**集群流控、链路模式的判断**都依赖它 | | `LogSlot` | 被规则拦截时记一条日志 | 常被忽略,但排查"到底是哪条规则拦的"时很有用 | | `StatisticSlot` | 记账:放行数、拦截数、RT、异常、并发线程数 | **顺序在规则之前**;它同时回调 `ProcessorSlotEntryCallback`,是扩展观测点 | | `AuthoritySlot` | 授权规则(来源黑白名单) | 依赖 `RequestOriginParser` 解析调用来源,未解析到来源时按配置策略处理 | | `SystemSlot` | 系统自适应保护 | **只对 `EntryType.IN` 生效**;把 `SystemRule` 与全局指标比对 | | `FlowSlot` | 流量控制 | 按 `FlowRule` 的阈值类型(QPS/线程数)、模式(直接/关联/链路)、效果(快速失败/预热/排队)判断 | | `DegradeSlot` | 熔断降级 | 维护熔断器状态机(CLOSED/OPEN/HALF_OPEN),决定本次是否直接拒绝 | 补充两点边界: - **热点参数限流**由 `ParamFlowSlot` 处理。它需要拿到方法的实参,因此和"带参数的 entry"绑定;部分版本通过独立的链构建器(如 `HotParamSlotChainBuilder`)把它挂到链尾,而不是出现在默认 8 环里——**具体挂在哪个位置需结合版本确认**,但它的判断逻辑一定在统计之后。 - **链的顺序可以自定义**:实现 `SlotChainBuilder` 并注册(SPI)即可调整,但生产上极少需要,改了要自己承担顺序语义被破坏的风险。 ### Q:StatisticSlot 记的到底是什么?为什么说它必须排在规则前面? A:结论先行——`StatisticSlot` 记录四类数据:**通过量(pass)、拦截量(block)、响应时间(RT)、并发线程数(concurrency)**,并写入按秒切分的滑动窗口。它排在规则之前,是因为所有规则(流控、熔断)都依赖"刚刚这一刻"的统计:如果统计在规则之后,规则看到的永远是上一轮的数据,限流会出现明显的超发。 `StatisticSlot` 的进入逻辑(示意,非源码原文): ```text entry() { 1. 先把"并发线程数 +1"(这样并发线程数限流能立刻看到本次调用) 2. 记录 pass 计数 3. 回调 ProcessorSlotEntryCallback.onPass(扩展点) 4. 继续 fireEntry → 走到后面的规则 Slot } 若后续 Slot 抛 BlockException: 1. 回滚并发计数 2. 记录 block 计数(按规则类型分别记 Flow/Degrade/System/Authority/ParamFlow) 3. 回调 onBlocked,再把异常继续往上抛 exit() { 1. 并发计数 -1 2. 把本次耗时累加进 RT 统计(区分 success / exception 两个维度) } ``` 关键点: - **RT 在 `exit()` 时才被记录**,这意味着"熔断的慢调用比例"依赖调用**结束后**的数据;所以熔断判断总有一次调用的滞后。 - **并发线程数限流看的是"还没 exit 的调用数"**,因此它天然对"响应变慢"敏感,是保护线程池的一道硬闸。 - 适用边界:这些统计都是**进程内单机指标**。跨机器的总量口径要靠集群流控解决,单机统计本身不跨节点聚合。 ## 三、资源的定义与调用链路 ### Q:在 Sentinel 里,"资源"一般怎么定义? A:结论先行——三种主流方式:**核心 API 手动定义**(`SphU.entry("资源名")`,最灵活)、**注解定义**(`@SentinelResource("资源名")`,最常用)、**框架自动适配定义**(Web 接口、Feign 调用、网关路由等由适配模块自动生成资源名)。资源名一旦定下来就成了规则匹配的唯一 key,改名要同步改规则。 ```java import com.alibaba.csp.sentinel.Entry; import com.alibaba.csp.sentinel.EntryType; import com.alibaba.csp.sentinel.SphU; import com.alibaba.csp.sentinel.slots.block.BlockException; public class OrderService { // 方式一:核心 API,适合无法用注解包裹的代码块(如某个 SDK 回调内部) public String queryByApi(String orderId) { Entry entry = null; try { // EntryType.OUT 表示"我主动去调用外部资源",Web 入口类资源才用 IN entry = SphU.entry("queryOrderById", EntryType.OUT); return doQuery(orderId); } catch (BlockException e) { // 被规则拦截:给出本地兜底,绝不把 BlockException 透给上层业务语义 return "系统繁忙,请稍后重试"; } finally { if (entry != null) { entry.exit(); } } } } ``` 关键点与适用边界: - `SphU.entry()` 有多个重载:带 `EntryType`、带 `count`(本次调用"消耗"多少配额,默认 1)、带方法实参(供热点参数限流使用)。 - **业务异常不要在这里 catch 掉**——`doQuery` 抛出的业务异常应当继续向上传播,Sentinel 在 `exit()` 里会把它记成异常(供"异常比例/异常数"熔断统计使用)。上面示例只 catch 了 `BlockException`,正是这个原因。 - 适用边界:手写 API 只建议用在"注解覆盖不到"的窄场景。手写最容易犯的错是**漏掉 `exit()`**(例如在 `try` 之前就 return),会造成并发计数只增不减,最后把并发限流"顶死"。 ### Q:调用链路与"调用树"是什么?为什么资源名相同却是不同的节点? A:结论先行——Sentinel 用一个**上下文(Context)**表示一条调用链,链上每一层资源对应树上的一个 `DefaultNode`;**同一个资源名,在不同 Context 下会是不同的 DefaultNode**,但它们会被 `ClusterBuilderSlot` 汇聚到**同一个 `ClusterNode`**。这就是"调用树"与"全局统计"的分工:树上有**链路关系**,ClusterNode 上有**资源总量**。 先看结构:  *图:Sentinel 资源调用树(Context / Node)* ```text Context(一次入口调用 = 一条调用链) └── EntranceNode (sentinel_default_context 的入口节点) ├── DefaultNode: "/api/order" ← 入口资源(EntryType.IN) │ └── DefaultNode: "getUserById" ← 该链路上的下游资源 │ └── DefaultNode: "queryUserDb" └── DefaultNode: "/api/cart" └── DefaultNode: "getUserById" ← 同名的另一个 DefaultNode(不同链路) 同时(资源维度,跨链路汇聚): ClusterNode: "getUserById" ← 上面两个 DefaultNode 都指向它,统计是"该资源全局"的 ``` 三个必须理解的点: 1. **DefaultNode 是"链路级"的**:它记录的是"在某条调用链路上,这个资源被调用的统计",并持有父节点的引用(`parent`)。**流控的"链路模式"**正是靠它实现的——只统计从某个入口进来的调用。 2. **ClusterNode 是"资源级/全局"的**:所有 DefaultNode 共享同一个 ClusterNode,所以 ClusterNode 的 QPS 就是"整个应用里这个资源的总 QPS"。**单机限流的阈值判断默认看 ClusterNode**。 3. **Context 是"线程本地"的**:`ContextUtil.enter(name)` 把上下文绑定到当前线程;跨线程(如异步、线程池提交任务)时上下文**不会自动传递**,需要手动传递上下文名或用 `ContextUtil.runOnContext` 之类的工具,否则会出现"统计散落到不同 Context、链路模式失效"的问题。 适用边界:默认情况下所有资源都挂在 `sentinel_default_context` 下,**只有需要区分调用来源(链路模式、来源限流)时才需要显式 `enter` 不同名字的 Context**。显式建 Context 会带来额外的节点数量,Context 数量与节点数量都有上限保护(超限时 Sentinel 会拒绝新建,避免内存被撑爆)。 ### Q:`@SentinelResource` 怎么用?有哪些容易被忽略的参数? A:结论先行——`@SentinelResource` 是"注解版的 `SphU.entry` + 自动兜底":`value` 指定资源名,`blockHandler` 处理被规则拦截(`BlockException`),`fallback` / `defaultFallback` 处理业务异常与熔断后的兜底。**它基于 AOP 代理生效**,同类内部方法自调用不走代理,注解会失效。 ```java import com.alibaba.csp.sentinel.annotation.SentinelResource; import com.alibaba.csp.sentinel.slots.block.BlockException; public class GoodsService { // 资源名 = "getGoods";被限流/熔断时走 blockHandler;业务异常走 fallback @SentinelResource(value = "getGoods", blockHandler = "getGoodsBlocked", fallback = "getGoodsFallback") public String getGoods(Long id) { if (id == null) { throw new IllegalArgumentException("id 不能为空"); } return remoteCall(id); } // blockHandler:参数列表必须与原方法一致,末尾多一个 BlockException;返回值类型一致 public String getGoodsBlocked(Long id, BlockException ex) { return "请求过于频繁,请稍后再试"; } // fallback:参数列表与原方法一致(或多一个 Throwable),返回值类型一致 public String getGoodsFallback(Long id, Throwable t) { return "商品服务暂时不可用"; } } ``` 关键参数与限制: | 参数 | 作用 | 关键限制 | |------|------|---------| | `value` | 资源名(不写则默认用方法全限定签名) | 规则按这个名字匹配,改名 = 换规则 | | `entryType` | 资源类型,默认 `OUT`;Web 入口类应设 `IN` | **系统规则只对 `IN` 生效** | | `blockHandler` / `blockHandlerClass` | 处理 `BlockException` | 方法需为 `public`,默认在**同一个类**中;若用 `blockHandlerClass` 指定到其他类,则该类中的方法**必须是 `static`**(否则无法解析) | | `fallback` / `fallbackClass` | 处理业务异常与熔断降级 | 返回类型必须与原方法一致;默认在**同一个类**中,用 `fallbackClass` 指定到其他类时该方法必须是 `static` | | `defaultFallback` | 通用兜底(无参或仅一个 `Throwable`) | 返回值类型需与原方法兼容;与 `fallback` 同时配置时的优先级**需结合版本确认**(通常 `fallback` 优先) | | `exceptionsToIgnore` | 声明"不参与降级统计/不由 fallback 处理"的异常 | 常用来排除参数校验类异常 | | `exceptionsToTrace` | 声明"要统计为异常"的异常类型 | 较新版本引入,低版本可能没有,需结合版本确认 | 三个最容易踩的点: 1. **同类内部自调用不生效**。`@SentinelResource` 靠 Spring AOP 代理拦截,`this.otherMethod()` 这种自调用不经过代理,注解形同虚设。解决方式是自注入代理对象、拆到另一个 Bean、或用 `AopContext.currentProxy()`。这条和 `@Transactional` 失效的原因完全一样。 2. **`blockHandler` 签名不匹配时,兜底不生效**。签名要求:方法为 `public`、参数与原方法一致、末尾追加 `BlockException`(或其子类,如 `FlowException`)、返回类型与原方法一致;**若把兜底放在 `blockHandlerClass` 指定的其他类里,那个方法还必须是 `static`**。任何一个条件不满足,兜底就会被跳过。 3. **`fallback` 必须与原方法返回类型一致**。返回类型不一致(例如原方法返回 `List`,兜底返回 `String`)会导致降级方法无法被正确调用。 适用边界:`@SentinelResource` 适合"业务方法级"的细粒度保护;如果是 Web 接口整体保护,通常不用手写注解——Spring Cloud Alibaba 的适配模块会自动把 URL 注册为资源,但那时**资源名是 URL(可能被归一化处理)**,与控制台里配的规则名要对得上。 ### Q:生产上第一周最容易配错的几件事是什么? A:结论先行——按出现频率排序:**① 系统规则配了不生效(因为资源不是 `IN`);② 规则名和资源名对不上(URL 被归一化/Feign 资源名是全限定签名);③ 规则只配在内存里,重启就没了;④ 注解资源被同类自调用绕过。** - **系统规则不生效**:`SystemSlot` 只处理 `EntryType.IN`。如果你在 Service 方法上加了 `@SentinelResource`(默认 `OUT`)然后配系统规则,是不会起作用的。Web 资源(`/api/...`)由适配模块注册为 `IN`,才是系统规则的正常作用面。 - **资源名对不上**:Web 资源名是 URL;Feign 资源名默认是"接口全限定名 + 方法签名";带路径参数的 URL 在不同版本里可能被归一化(`/order/1` 与 `/order/2` 归成一类)。**改名前先去控制台看"簇点链路"里实际显示的资源名**,照着配。 - **规则不持久化**:默认规则存在应用内存里,应用一重启就回到初始状态;控制台里"改完规则重启丢了"是同一个原因,需要接入外部数据源(Pull/Push)。 - **同类自调用绕过注解**:见上一节的坑 1。 ## 四、小结与延伸 ### Q:把这一篇压缩成几句话 A:结论先行——**Sentinel = 资源 + 规则 + 责任链**。 - 它解决的是三类问题:**限流、熔断降级、系统自适应保护**;核心是"有序地拒绝"。 - 与 Hystrix 的关键差异:Hystrix 靠**线程池/信号量隔离 + 错误率熔断**,Sentinel 靠**统计 + 规则**、以限流为主业;**Sentinel 不提供超时控制**。 - 核心概念:**资源**(保护对象)、**规则**(策略)、**Entry**(一次调用的门票)。 - Slot 链默认顺序:`NodeSelectorSlot → ClusterBuilderSlot → LogSlot → StatisticSlot → AuthoritySlot → SystemSlot → FlowSlot → DegradeSlot`;**统计必须在规则之前**。 - 链路与调用树:**DefaultNode 是链路级、ClusterNode 是资源级**;Context 绑定线程,跨线程需手动传递。 - `@SentinelResource` 基于 AOP,注意 **自调用失效**、**签名匹配**、**返回类型一致**。 ## 小结 - Sentinel 用"资源 + 规则 + 责任链"把稳定性变成可配置、可动态调整的能力,覆盖限流、熔断降级、系统自适应保护三块。 - 与 Hystrix 的最大差异在于隔离模型(无线程池隔离)与能力边界(Sentinel 提供 QPS 限流与系统保护,但不提供超时控制);Hystrix 已进入维护模式。 - 三个核心概念必须分清:资源是保护对象,规则是策略(按资源名匹配),Entry 是一次调用的通行证(`entry`/`exit` 必须配对)。 - Slot 链顺序固定且有序逻辑:**先建节点 → 再统计 → 后判规则**;系统规则只对 `EntryType.IN` 生效。 - 调用树上,`DefaultNode` 表达链路、`ClusterNode` 表达资源全局;`Context` 绑定线程,异步场景要手动传递。 - `@SentinelResource` 的参数有严格签名约定,且受 AOP 代理限制,自调用会失效。 ## 思考题 1. 为什么 Sentinel 把 `StatisticSlot` 排在所有规则 Slot 之前?如果把它挪到 `FlowSlot` 之后,限流会出现什么现象? 2. Hystrix 的线程池隔离和 Sentinel 的"并发线程数限流"分别在防什么?为什么说 Sentinel 的这套做法**不能**替代调用超时? 3. 同一个资源名 `getUserById` 在两个不同的 Context 下各有一个 `DefaultNode`,那么"这个资源的总 QPS"应该看哪个节点?"从某个入口进来的 QPS"又该看哪个节点? 4. 你在 Service 方法上加了 `@SentinelResource` 并配了系统规则,压测时系统规则完全不生效——最可能的原因是什么?怎么改? 5. 手写 `SphU.entry()` 时漏掉了 `entry.exit()`,系统运行一段时间后会有什么可观测的异常现象?
预览
发布文章
添加摘要让读者更快了解文章内容
取消
确认发布
AI 写作助手
输入一个主题,AI 将为你生成一篇 Markdown 博客文章
AI 正在写作中...
取消
开始生成
AI 优化助手
描述你的修改需求,AI 将在原文基础上进行补充或微调
AI 正在优化中...
取消
开始优化
画布
从已有图里选
✕
图名
保存后生成 /images/excalidraw/<图名>.svg(只能用字母、数字、短横线、下划线、点)
取消
保存并插入