知序
返回
保存草稿
发布
H1
H2
H3
1
2
3
Excalidraw 图
AI 写作
AI 优化
目录
输入内容后显示目录
Markdown
# Sentinel 生产实践 > 导读:本文从"本地演示时规则好使,一上生产就出现规则重启丢失、控制台看不到应用、注解莫名失效、限流阈值对不上总量"这一连串具体痛点出发,把规则的四种持久化方式与为什么必须持久化、与控制台的对接细节、集群流控(token server / token client)的两种模式、与 Spring Cloud Alibaba / OpenFeign / Spring Cloud Gateway 的整合要点、以及五类高频生产坑逐项讲透。适合已经把 Sentinel 跑通 demo、准备接入真实生产环境的同学。 ## 一、先建立全局认知 ### Q:为什么 Sentinel 的规则"必须持久化"? A:结论先行——因为 Sentinel 客户端的默认规则存储是**纯内存**的,而**控制台默认也把规则存在内存里**。这意味着:应用一重启,规则就回到初始状态;控制台一重启,你在线调过的规则也一起没了。而重启这件事,恰恰最常发生在发布和故障处理时刻——**也就是最需要保护的时刻**。 先把这件事的链路说清楚(这是所有"规则丢失"问题的总源头):  *图:控制台与客户端各存内存,重启规则全丢* ```text 【不持久化的默认形态:规则只活在各自的内存里】 Sentinel 控制台(Dashboard) 应用实例 InMemoryRuleRepository FlowRuleManager (规则存在控制台自己的内存) (规则存在客户端内存) │ ▲ └──────── 推送规则:HTTP 调客户端接口 ─────────────┘ ▲ ▲ 控制台重启 → 规则全丢 应用重启 → 规则全丢 ``` 具体危害逐条列出来: 1. **应用重启丢规则**:发布、扩容、OOM 重启后,所有限流/熔断规则消失,此时如果正好有流量高峰,等于完全裸奔。 2. **多实例不一致**:控制台推送规则时按实例逐个推送,如果某个实例当时网络异常或没注册上,它会一直"没有规则",而其他实例有规则——**同一份配置在不同实例上行为不同**,是最难排查的一类问题。 3. **控制台重启丢规则**:控制台默认用内存仓库保存规则,进程重启后你在界面上的所有配置都没了,且**没有任何持久化痕迹可回溯**。 4. **无法审计与版本化**:规则变更没有记录、没有 diff、不能回滚。真出了事故,你连"当时的阈值是多少"都说不清。 **结论:生产环境必须把规则外置到配置中心或数据库,由数据源统一驱动客户端,控制台只做"读写入口",不做"存储"。** ## 二、规则持久化 ### Q:规则的四种持久化方式分别是什么? A:结论先行——按"谁来驱动规则更新"分成四类:**原始模式(纯内存)**、**Pull 模式(客户端主动定时拉取)**、**Push 模式(配置中心主动推送,即客户端监听)**、以及**控制台改造模式(把控制台的规则落到配置中心)**。生产推荐 **Push 模式 + 控制台改造**,Pull 模式适合不便引入配置中心的场景。 | 模式 | 谁触发更新 | 数据来源 | 一致性 | 实时性 | 适用场景 | |------|-----------|---------|--------|--------|---------| | 原始模式 | 无(代码里 `loadRules` 或控制台 API 推送) | JVM 内存 | 差(各实例独立) | 推送即时,但重启即失 | 本地开发、单机 demo | | Pull 模式 | 客户端定时任务 | 本地文件 / DB / 配置中心的读接口 | 中(有轮询间隔) | 取决于轮询周期 | 已有自研配置系统、不便接推送 | | Push 模式 | 配置中心变更事件 | Nacos / ZooKeeper / Apollo / Redis 等 | 好(配置中心做统一存储与广播) | 近实时(监听回调) | 生产首选 | | 控制台改造 | 控制台写配置中心 → 配置中心推送 | 配置中心 | 好 | 近实时 | 生产首选(配合 Push 模式) | 关键点: - **Pull 模式的本质缺陷是"延迟与漏拉"**:客户端按固定周期去拉,规则变更到生效之间存在一个轮询间隔的窗口;如果拉取失败还没做重试,就会长期使用旧规则。它实现简单、依赖少,是"退而求其次"的方案。 - **Push 模式依赖"数据源 + 监听器"**:Sentinel 提供了一系列 `DataSource` 实现(Nacos、ZooKeeper、Apollo、Redis 等),它们注册监听器,配置一变就回调 `loadRules`。**这是生产环境的主流做法**。 - **控制台改造是"Push 模式"的配套**:Sentinel 官方控制台**默认把规则存在内存**,即使你客户端接了配置中心,在控制台上改的规则也不会自动落到配置中心。所以要么**改造控制台**(把规则的读写都换成配置中心),要么**禁止在控制台改规则**,改为在配置中心里直接维护。 ### Q:Push 模式怎么接 Nacos?给一个可用的骨架。 A:结论先行——核心是"构造一个 `NacosDataSource`,注册到对应的 `RuleManager` 上"。`NacosDataSource` 内部会监听 Nacos 上对应的 dataId/group,拿到配置后用你提供的转换器(Parser)把文本转成规则对象,再交给 RuleManager。 ```java import com.alibaba.csp.sentinel.datasource.Converter; import com.alibaba.csp.sentinel.datasource.nacos.NacosDataSource; import com.alibaba.csp.sentinel.slots.block.flow.FlowRule; import com.alibaba.csp.sentinel.slots.block.flow.FlowRuleManager; import com.alibaba.fastjson.JSON; import com.alibaba.nacos.api.PropertyKeyConst; import java.util.List; import java.util.Properties; public class NacosRuleDataSource { public static void init() { Properties properties = new Properties(); // 占位符:请替换为你自己的 Nacos 地址与命名空间,不要在代码里硬编码密钥 properties.put(PropertyKeyConst.SERVER_ADDR, "nacos-host:8848"); properties.put(PropertyKeyConst.NAMESPACE, "your-namespace"); // 文本 → 规则列表 的转换器 Converter<String, List<FlowRule>> parser = json -> JSON.parseArray(json, FlowRule.class); NacosDataSource<List<FlowRule>> dataSource = new NacosDataSource<>( properties, "SENTINEL_GROUP", // group "order-service-flow-rules", // dataId parser ); // ★ 注册到 FlowRuleManager:此后 Nacos 上这条配置一变,客户端规则立刻更新 FlowRuleManager.register2Property(dataSource.getProperty()); } } ``` 关键点与适用边界: - **每个规则类型要分别注册**:`FlowRuleManager`、`DegradeRuleManager`、`SystemRuleManager`、`AuthorityRuleManager`、`ParamFlowRuleManager` 是各自独立的规则仓库,需要分别挂数据源、分别用对应的 dataId 维护。**只挂了流控规则却没挂熔断规则,是"熔断规则重启就丢"的常见原因。** - **注册要用 `register2Property`**(把数据源的 `Property` 交给 RuleManager),而不是手动 `loadRules`。手动 `loadRules` 只会写一次内存,后续配置中心的变化不会自动生效。 - **转换器(Parser)决定配置格式**:上面用 JSON 反序列化成 `FlowRule` 列表。规则里的字段名必须与 `FlowRule` 的属性名对应(例如 `resource`、`grade`、`count`、`strategy`、`controlBehavior`),**字段值建议使用常量对应的数字或明确约定**,避免"看起来配了但解析不出来"。 - **Apollo / ZooKeeper 的接法与 Nacos 同构**:都是"构造对应 DataSource → 传转换器 → `register2Property`"。差异只在构造参数(命名空间、集群、路径等)与配置格式约定上,接入前请对照官方 `sentinel-datasource-*` 模块的 README,**具体构造参数需结合版本确认**。 - 适用边界:Push 模式要求应用能连上配置中心。**配置中心一旦不可用,规则不会"变成空"——客户端会继续用最后一次成功加载的规则**;但如果你在应用启动时配置中心就不可达,规则可能是空的,需要接受"启动期无规则"或做本地兜底缓存。 ### Q:Pull 模式和"控制台改造"各要注意什么? A:结论先行——**Pull 模式**的要点是"轮询周期 + 本地兜底 + 变更幂等";**控制台改造**的要点是"把控制台的规则仓库从内存换成配置中心,并保证改完能立刻推送"。两者都别指望开箱即用,都需要写代码或改代码。 Pull 模式的注意点: - **Pull 模式需要自己实现"拉取 + 解析 + 加载"这条链路**(Sentinel 提供了 `FileRefreshableDataSource` 这类现成实现,也提供了扩展点,从 DB 拉取通常要自己写 `DataSource`)。 - **轮询周期要和"规则的时效要求"匹配**:秒级就够用的场景用短周期;但如果周期太短,会对数据源造成压力。规则不是实时交易数据,**没必要追求亚秒级**。 - **要做本地兜底**:拉取失败时保留上一次的规则,而不是清空。规则被清空 = 保护失效,比用"旧规则"危险得多。 - **要幂等**:同一份规则被重复加载多次不应产生副作用(RuleManager 的加载本身是覆盖式的,天然幂等,但如果你的 `DataSource` 在加载时还做了别的动作,要注意)。 控制台改造的注意点: - **官方控制台不持久化,这是设计取舍而不是 bug**:控制台的定位是"规则下发与实时监控入口",存储交给外部。所以要么改造,要么接受"控制台只读、规则只在配置中心改"。 - **改造的关键是重写"规则仓库(RuleRepository)"与"推送链路"**:把控制台的读写从内存仓库换成配置中心;同时推送链路要改成"写配置中心 → 配置中心广播给所有客户端"。这样做的好处是**客户端实例的增减不再影响规则一致性**(新实例启动时也能从配置中心拿到全量规则)。 - **改造要覆盖全部规则类型**:流控、熔断、系统、授权、热点参数、网关流控(如果用了网关),漏一类就是一类规则在生产上"时有时无"。 - 适用边界:如果团队没有能力维护改造后的控制台,**更务实的做法是"控制台只用于观测,规则统一在配置中心里以文本形式维护"**。牺牲一点便利性,换来确定性与可审计性。 ## 三、与控制台对接与集群流控 ### Q:应用接不上控制台,一般卡在哪几个点? A:结论先行——三个点:**应用名(app name)没设置或重复**、**dashboard 地址/网络不通**、**懒加载导致"没请求就看不到"**。另外客户端与 dashboard 之间是**反向的**:客户端主动向控制台发心跳注册,控制台再通过客户端暴露的**通信端口**去拉取指标、推送规则。  *图:Sentinel 应用实例与控制台的心跳注册* ```text 应用实例 A Sentinel 控制台(Dashboard) ──────────────────────────────────────────── ───────────────────────────────── ① 心跳注册(客户端主动发出) 带上 appName / ip / port ─────────────► 记录"应用名 → 机器列表(ip:port)" ② 暴露通信端口(客户端开服务) csp.sentinel.api.port ◄───────────── 拉指标 / 推送规则(控制台主动发起) ``` 对接要点清单: | 项 | 配置/行为 | 常见现象 | |----|----------|---------| | 应用名 | 由 `project.name` / `spring.application.name` 决定,尽量用 `-Dproject.name=xxx` 显式指定 | 名字没设 → 控制台里显示默认名或被合并;多应用同名 → 控制台里互相覆盖 | | 控制台地址 | `csp.sentinel.dashboard.server` / `spring.cloud.sentinel.transport.dashboard` | 配错地址或端口 → 控制台里根本看不到这个应用 | | 客户端通信端口 | `csp.sentinel.api.port`(默认 8719,**以版本为准**),被占用时会尝试递增 | 同机部署多实例 → 端口冲突;容器/宿主机端口映射没配好 → 控制台能收到心跳但拉不到指标 | | 懒加载 | 客户端默认懒加载:**首次访问资源时才初始化**;可配 `csp.sentinel.eager=true` 提前初始化 | 应用启动后没有流量 → 控制台看不到;规则也在首次访问后才真正生效 | | 心跳间隔 | 客户端周期性发心跳(间隔以版本为准) | 网络抖动期间控制台显示"机器离线",但客户端仍在自我保护 | 应用侧的三个关键参数也可以直接用 JVM 参数显式给死,避免依赖适配层的默认值: ```bash # 显式指定应用名、控制台地址、客户端通信端口,并开启提前初始化 java -Dproject.name=order-service \ -Dcsp.sentinel.dashboard.server=127.0.0.1:8080 \ -Dcsp.sentinel.api.port=8719 \ -Dcsp.sentinel.eager=true \ -jar order-service.jar ``` 上面的 `csp.sentinel.*` 是 Sentinel 客户端的原生配置项名;用 Spring Cloud Alibaba 时通常改写成对应的 `spring.cloud.sentinel.*` 配置更统一,两者**具体命名与是否同时生效需结合版本确认**。 两个必须理解的机制: 1. **"控制台看不到应用" ≠ "客户端没启动"**。判断顺序是:先看应用日志里有没有注册/心跳相关记录 → 再看应用名是否与控制台上显示的一致 → 再看网络与端口是否可达 → 最后看是否因为懒加载而没有资源被初始化。 2. **懒加载是"省资源"的设计,不是缺陷**。如果应用启动后长时间没有流量,Sentinel 的统计与规则判断实际上没有"工作对象",提前初始化会带来启动开销。生产上建议**显式开启 eager 初始化**(`csp.sentinel.eager=true`,配合框架对应配置),这样规则在启动时就位、控制台也能立刻看到应用,避免"发布后头几秒裸奔"。**具体配置项名称随版本/框架适配层可能不同,需结合版本确认。** ### Q:为什么要做集群流控?单机限流不够用吗? A:结论先行——**单机限流的阈值是"每台实例"的阈值**,它有两个绕不过去的问题:**总阈值随实例数漂移**(10 台 × 100 = 1000,扩到 20 台就变成 2000),以及**流量不均导致部分实例先被打到限流、其他实例却在挨饿**。集群流控把"总配额"集中管理,解决的就是这两件事。  *图:单机限流阈值失真 vs 集群流控统一发令牌* ```text 单机限流(阈值 100/台,共 3 台 → 隐含总量 300): 负载均衡不均 流量 250 ──► ├── 实例A 收到 150 → 超过 100 → 限流拒绝 50(浪费) ├── 实例B 收到 60 → 未达阈值 → 全放行 └── 实例C 收到 40 → 未达阈值 → 全放行 结果:总量明明没超 300,却拒绝了 50 个请求 → 阈值"名不副实" 集群流控(全局阈值 300,token server 统一发令牌): 流量 250 ──► token server(全局计数 250/300)──► 全部放行 流量 400 ──► token server(全局计数已达到 300)──► 拒绝 100,各实例一致 ``` 集群流控的两个角色: | 角色 | 职责 | 说明 | |------|------|------| | Token Server | 统一维护**全局**统计并按全局阈值发放令牌 | 规则与统计的中心,是集群流控的"大脑" | | Token Client | 各应用实例,向 server 申请令牌 | 拿到令牌才放行,拿不到则拒绝 | 两种部署模式: | 模式 | 部署方式 | 优点 | 缺点 | |------|---------|------|------| | 嵌入式(embedded) | **指定集群中的某一个实例**同时充当 server | 不额外占用机器、部署简单 | server 是该实例的一部分,实例重启/故障会影响集群限流能力;server 侧还承担额外负载 | | 独立模式(standalone) | server **单独部署**成一个进程 | 隔离性好、可独立扩缩容、可服务多个应用 | 多一份部署与运维成本,server 自身的高可用要自己保证 | 关键点与适用边界: - **集群流控的核心风险在 token server 本身**:它是全局决策点,一旦不可用,"统一限流"就无从谈起。**官方提供的是基础实现,server 的高可用(多实例、故障转移、与注册中心联动)需要结合你的场景自行设计**,不要把单点 server 直接放上生产。 - **集群模式的阈值有两种口径**:一种是"**全局阈值**"(整个集群总共允许多少),另一种是"**单机均摊阈值**"(按 `单机阈值 × 实例数` 折算成全局)。这两种在语义上差别很大,**配错会导致阈值量级差异巨大**——配置时务必确认控制台/API 里选的是哪一种,**具体字段名与取值需结合版本确认**。 - **集群流控有额外的通信开销**:每次放行判断都可能涉及一次远程调用。所以它适合**阈值敏感、总量必须精确控制**的核心接口(如下游只允许 500 QPS),不适合**所有接口无脑开集群**。 - **不是所有模式都支持集群**:集群限流的适用范围与"流控模式/流控效果"的组合有关,**具体支持矩阵需结合版本确认**。 - 适用边界:实例数较多(十几台以上)、总量阈值有硬约束、且流量分布不均时,集群流控的收益最明显。实例数很少(2~3 台)且负载均衡均匀时,单机限流 + 留出余量往往更简单可靠。 ## 四、生态整合要点 ### Q:和 Spring Cloud Alibaba 整合,自动装配帮你做了什么? A:结论先行——它做了三件事:**把 Web 接口自动注册为资源**(默认资源名是 URL)、**把 `@SentinelResource` 的 AOP 切面装配好**、**把控制台对接与数据源接入做成配置项**。也就是说,引入 starter 之后你不需要再手写 `SphU.entry`。 ```yaml spring: application: name: order-service # 直接决定控制台里显示的应用名 cloud: sentinel: transport: dashboard: sentinel-dashboard-host:8080 # 控制台地址 port: 8719 # 客户端对外通信端口(被占用会尝试递增) eager: true # 提前初始化,避免懒加载导致"发布初期无规则" # filter / web-context-unify 等开关随版本不同,接入前请对照对应版本文档 ``` ```java // RestTemplate 也可以被 Sentinel 保护:用注解声明兜底方法 @Bean @SentinelRestTemplate( blockHandler = "handleBlock", blockHandlerClass = RestTemplateBlockHandler.class, fallback = "handleFallback", fallbackClass = RestTemplateFallbackHandler.class) public RestTemplate restTemplate() { return new RestTemplate(); } ``` 关键点与适用边界: - **Web 资源名默认是 URL 路径**,而不是方法名。控制台里"簇点链路"看到的就是实际资源名,**照着它配规则**,不要凭猜测写。 - **URL 归一化(UrlCleaner)**:带路径参数的 URL 如果不做归一化,每个不同的路径值都会变成一个独立资源(`/order/1`、`/order/2`……),既浪费统计资源、又无法统一配规则。较新版本对 RESTful 风格 URL 有内置的归一化处理,也可以自定义 `UrlCleaner` 覆盖。**归一化的默认行为随版本变化,需结合版本确认。** - **`@SentinelResource` 依然受 AOP 代理限制**:同类自调用不走代理,注解失效。这条在框架整合下同样成立,不因为引入 starter 而改变。 - **配置项的 key 在不同 Spring Cloud Alibaba 版本间有调整**(例如 filter 相关、网关相关的 key),**升级框架版本时必须核对配置项**,否则会出现"配置写了但不生效"。 ### Q:和 OpenFeign 整合要注意什么? A:结论先行——打开 `feign.sentinel.enabled=true` 后,**每个 Feign 方法都会自动成为一个 Sentinel 资源**(资源名是接口的全限定方法签名),并且**Feign 的 `fallback`/`fallbackFactory` 改由 Sentinel 触发**——但它只在**被 Sentinel 拦截(`BlockException`)**时触发,业务异常不会走 Feign 的 fallback。 ```yaml feign: sentinel: enabled: true # 开启后 Feign 接口的资源由 Sentinel 保护 ``` 关键点: - **资源名是"接口全限定名 + 方法签名"**,例如 `com.example.api.UserApi:getUser(Long)` 这种形态。**配置规则时不要在控制台里手敲,直接去"簇点链路"里复制。** - **Feign 的 fallback 语义变窄了**:开启 Sentinel 后,`fallback`/`fallbackFactory` 主要用来处理"被限流/熔断"这类 `BlockException`。**远端返回 500、反序列化失败这类业务/协议异常,不会触发 Feign 的 fallback**,需要在 Feign 的 `ErrorDecoder` 或调用方自己的 `fallback`/`try-catch` 里处理。**这一行为在不同版本上有过调整,需结合版本确认。** - **不要同时用 Hystrix 和 Sentinel 保护 Feign**:两者都做熔断,同时开启会造成语义重叠与奇怪行为。**确认 `feign.hystrix.enabled` 处于关闭状态(或与你的框架版本的默认值一致)。** - **Feign 调用的 `EntryType` 是 `OUT`**,因此系统规则(只对 `IN` 生效)不会作用在 Feign 资源上——这是符合语义的:Feign 是"我调出去",不是"别人调进来"。 - 适用边界:Feign 资源适合配**熔断规则**(保护自己不被下游拖死)和**线程数限流**;至于"限总量",通常更应该在网关或服务入口做,而不是在每个下游调用上做。 ### Q:和 Spring Cloud Gateway 整合有什么不同? A:结论先行——网关场景需要引入**专门的适配模块**(`spring-cloud-alibaba-sentinel-gateway`),它提供的是**网关维度的流控规则**(`GatewayFlowRule`,按 route 或自定义 API 分组限流)和一个**全局过滤器**(`SentinelGatewayFilter`)。网关的粒度比微服务接口粗,适合做"入口总闸"。 ```yaml spring: cloud: sentinel: scg: fallback: mode: response # 被限流时的兜底方式(response / redirect,取决于版本支持) response-status: 429 # 兜底响应状态码 response-body: '{"code":429,"msg":"too many requests"}' ``` 关键点: - **网关流控的"资源"是 route id 或自定义 API 分组**,不是后端接口 URL。所以"网关规则"和"微服务规则"是**两套**,不能互相复用。 - **可以在网关做"按调用方来源限流"**:网关能拿到更完整的请求特征(header、路径、参数),适合做租户级/调用方级的入口限流。这比在微服务内部做来源识别更可靠(微服务内部的来源标识往往是上游随手填的)。 - **网关层的兜底要做成"标准错误响应"**:通过 `fallback` 配置返回统一的 429 结构和状态码,而不是让请求超时或返回 500。 - **网关本身的稳定性优先级最高**:网关是最典型的"IN 入口",**系统自适应保护在网关上的价值最大**。但也要注意网关的 RT 基线通常很低(只做转发),`avgRt` 阈值不要套用业务服务的值。 - 适用边界:网关适合做**总量与来源维度的粗粒度保护**;细粒度的"某个业务资源限多少"仍然应该落在微服务里。两层都配的好处是"网关挡住大流量、微服务兜住个性化阈值"。 ## 五、常见坑 ### Q:坑一——规则丢失、重启失效,怎么排查与根治? A:结论先行——先确认**是"客户端没规则"还是"控制台没规则"**:客户端没规则 → 数据源没接或没注册到 RuleManager;控制台没规则 → 控制台用的是内存仓库,重启就丢。 排查顺序: 1. **看客户端启动日志**:有没有数据源初始化、规则加载的记录。如果完全没有,说明数据源代码根本没被触发(比如写在了不会被执行的初始化方法里)。 2. **看是"全部规则都没了"还是"某一类规则没了"**:全部没了 → 数据源整体没接上;某一类没了 → 那一类没有注册数据源(**`DegradeRuleManager` 忘记注册极其常见**)。 3. **看配置中心的配置内容**:dataId/group 对不对、JSON 能不能被转换成规则对象(字段名对不上会解析失败,通常是静默的)。 4. **看是不是只用了 `loadRules`**:`loadRules` 只写一次内存,不监听配置中心变化;必须用 `register2Property` 这类注册方式。 根治方式:**所有规则类型都接 Push 数据源 + 控制台改造(或控制台只读)**。这里要记住一条判断原则:**"最后一次成功加载的规则"比"没有规则"安全得多**,所以任何数据源方案都要在拉取/监听失败时**保留旧规则**,不要清空。 ### Q:坑二——`@SentinelResource` 明明加了却不生效,为什么? A:结论先行——九成是**AOP 代理没有生效**。最常见的五类原因按概率排序:**同类内部方法自调用**、**方法不是 public**、**类不是 Spring Bean**、**方法是 final/private**、**AOP 执行顺序被其他切面打断**。 ```java @Service public class OrderService { public String create(String id) { // ✗ 自调用:this.query(...) 不经过代理 → @SentinelResource 完全失效 return this.query(id); } @SentinelResource(value = "queryOrder", blockHandler = "blocked") public String query(String id) { return "ok"; } public String blocked(String id, BlockException ex) { return "blocked"; } } ``` 修复的三种方式: 1. **自注入代理对象**:注入自己的代理(注意循环依赖风险),用 `self.query(id)` 调用。 2. **拆分到另一个 Bean**:把被注解保护的方法挪到另一个 Spring Bean 里,通过依赖注入调用——**最干净的做法**。 3. **`AopContext.currentProxy()`**:开启 `exposeProxy` 后拿到当前代理再调用,属于"能解决问题但不推荐"的写法(隐式依赖、可读性差)。 验证方式:**在控制台的"簇点链路"里看这个资源名是否出现过**。如果从来没出现过,就是代理没生效或方法没被调用;如果出现了但规则没按预期拦,那问题在规则配置(资源名/阈值/来源)而不是代理。 ### Q:坑三——`blockHandler` / `fallback` 配了但兜底没走,怎么定位? A:结论先行——**签名不匹配**。Sentinel 通过反射按名字找方法,找不到就直接放弃兜底(抛原始异常),且**大多数情况下不会给你显式的报错**。按下面这张表逐项核对,基本能覆盖全部情况。 | 检查项 | 正确形态 | 错误形态 | |-------|---------|---------| | 方法位置 | 默认在**同一个类**里(或用 `blockHandlerClass`/`fallbackClass` 指定类) | 写在别的类里却没指定 Class | | 方法修饰 | 同类中为 `public`(可写实例方法);**用 `blockHandlerClass`/`fallbackClass` 放到其他类时必须是 `static`** | `private`(不可见);跨类却漏了 `static` | | 参数列表 | 与原方法**参数完全一致**,`blockHandler` 末尾**追加 `BlockException`** | 少参、多参、类型不一致、`BlockException` 位置不对 | | 异常参数类型 | `blockHandler` 用 `BlockException`(或其子类);`fallback` 用 `Throwable`/`Exception` | 位置或类型写反 | | 返回类型 | **与原方法返回类型一致** | 返回 `Object`、返回类型不同 | | 方法名拼写 | 注解里的字符串 = 方法名,**大小写敏感** | 少个字母、驼峰写错 | | 重载歧义 | 参数列表唯一 | 同名重载导致反射选错方法 | 补充两条容易被忽略的: - **`exceptionsToIgnore` 会把异常排除出 fallback**。如果你把某个异常加进了 ignore 列表,又期待它走 fallback,就会"看起来兜底没生效"。 - **泛型/包装类型的返回兼容性**:原方法返回 `List<Order>`、兜底返回 `Collections.emptyList()` 是没问题的(运行时都是 `List`);但原方法返回 `int`、兜底返回 `Integer` 就可能因为自动装箱/反射类型不匹配出问题。**保持签名逐字一致最稳妥。** ### Q:坑四——资源名被"改写"了,规则怎么都对不上,怎么办? A:结论先行——**资源名由适配层决定,不由你决定**。Web 接口是 URL(可能被归一化)、Feign 是接口全限定方法签名、网关是 route id 或 API 分组、`@SentinelResource` 才是你写的 `value`。**配规则前一定先去控制台"簇点链路"里看实际名字。** ```text 不同来源的资源名形态(示意,实际形态随版本与配置变化) Web 接口(未归一化) : /api/order/1001、/api/order/1002 → 每个 id 一个资源 ✗ Web 接口(已归一化) : /api/order/{id} 或 /api/order/** → 一个资源 ✓ Feign 调用 : com.example.api.UserApi:getUser(Long) Gateway route : 路由 id(或自定义 API 分组名) @SentinelResource : 注解 value 里写什么就是什么 ``` 处理办法: - **先看后配**:在控制台"簇点链路"里找到真实资源名,复制粘贴到规则里,不要手敲。 - **主动归一化 URL**:通过框架提供的 URL 归一化能力或自定义 `UrlCleaner`,把带路径参数的 URL 收敛成一个资源。**归一化规则一旦改变,旧规则会立刻失配**,升级版本时要重点回归。 - **统一资源命名规范**:优先用 `@SentinelResource` 显式声明资源名(可控、可读、可跨框架一致),把"框架自动生成的资源名"只用在确实无法加注解的入口层。 - **注意 `limitApp` 的"来源"也可能是被改写的**:来源由 `RequestOriginParser` 解析,解析器换了、header 名改了,看起来"规则生效范围"就变了。 ### Q:坑五——还有哪些"上线才发现"的问题? A:结论先行——列几条高频但容易忽略的:**同机多实例的通信端口冲突**、**应用名重复导致控制台数据互相污染**、**兜底方法里又发起远程调用**、**规则阈值随实例数漂移**、**异步/线程池导致 Context 丢失**。 - **通信端口冲突**:同一台机器上跑多个实例时,客户端通信端口(默认 8719)会冲突,虽然一般会尝试递增,但**容器端口映射/防火墙规则如果不覆盖递增后的端口,控制台就拉不到指标**。同机多实例建议**显式指定不同端口**。 - **应用名重复**:多个不同服务用了同一个 `project.name`,控制台会把它们当成同一个应用,**指标混在一起、规则互相覆盖**。每个服务必须有唯一的应用名。 - **兜底方法里又调远端**:降级方法应当"就地取材"(本地缓存、默认值、静态提示)。在兜底里再发一次远程调用,等于绕过了熔断重新把压力打给不可用的依赖,**这是把降级做成二次放大器**。 - **阈值随实例数漂移**:单机阈值 × 实例数 = 实际总配额。扩容后总配额自动翻倍,可能直接击穿下游的保护线。**有总量约束的接口要么用集群流控,要么在扩缩容时同步调整单机阈值(并把这条写进发布流程)。** - **异步/线程池导致 Context 丢失**:Context 是线程绑定(ThreadLocal),把任务丢进线程池后,子线程拿不到父线程的 Context。后果是**链路模式失效、统计落到别的链路上、调用树断裂**。需要手动传递上下文名(或在框架支持的场景下使用上下文传递工具),**具体 API 需结合版本确认**。 - **规则变更没有回滚预案**:把阈值从 100 改成 10 只要一次点击,但线上顶不住可能只需要一次点击。**建议所有规则变更走配置中心的版本管理,并保留一键回滚能力。** ## 六、小结与延伸 ### Q:把这一篇压缩成几句话 A:结论先行——**规则外置、控制台只读、集群限流慎用、整合看清单、兜底靠日志**。 - **持久化**:默认规则在内存,重启即失;生产必须用 Push 数据源(Nacos/ZooKeeper/Apollo 等),并**每类规则都注册**。 - **控制台**:默认不持久化规则,改造或改为"只读观测 + 配置中心维护";对接要靠应用名、dashboard 地址、通信端口三件套,懒加载要显式打开 eager。 - **集群流控**:解决"总阈值漂移"和"流量不均",由 token server / token client 组成,有嵌入式与独立两种模式;**server 是新的风险点,高可用要自己设计**。 - **整合**:Spring Cloud Alibaba 自动注册 Web 资源、装配注解切面;OpenFeign 的资源名是全限定方法签名且 fallback 主要处理 `BlockException`;Gateway 用独立的 `GatewayFlowRule` 做入口总闸。 - **五类坑**:规则丢失、注解代理失效、兜底签名不匹配、资源名被改写、以及端口/应用名/异步上下文这些"环境类"问题——**绝大多数都能通过"先看控制台簇点链路、再看日志、再核对签名"三步定位**。 ## 小结 - Sentinel 客户端与控制台的默认规则存储都是内存,重启即失;生产必须把规则外置到配置中心(Push 模式优先)。 - 规则持久化要覆盖所有规则类型,且必须用"注册数据源"的方式(而非一次性 `loadRules`),拉取失败时保留旧规则。 - 控制台对接的三个关键点:唯一的应用名、正确的 dashboard 地址与可达的通信端口;懒加载会导致"无流量就看不到、无规则",建议开启 eager 初始化。 - 集群流控解决总阈值漂移与流量不均,代价是引入 token server 这个新的核心依赖,需自行设计其高可用。 - Spring Cloud Alibaba 负责 Web 资源注册与注解切面;OpenFeign 资源名是全限定签名且 fallback 主要响应 `BlockException`;Gateway 走独立的网关流控规则。 - 高频坑集中在"规则持久化""AOP 代理""签名匹配""资源名改写""环境配置"五类,定位路径是**控制台簇点链路 → 应用日志 → 方法签名核对**。 ## 思考题 1. 你的应用接了 Nacos 数据源,但重启后熔断规则总是丢——最可能漏了什么?怎么验证? 2. 单机阈值 100 QPS,实例数从 5 台扩到 20 台。下游只允许 1500 QPS,会出什么问题?有哪两种解法? 3. 引入 `spring-cloud-starter-alibaba-sentinel` 后 Web 资源名是 `/order/1`、`/order/2` 这种形态,规则配一个漏一个——发生了什么?怎么改? 4. 你给 Feign 配了 `fallbackFactory`,但下游返回 500 时兜底没生效。为什么?这个兜底到底在什么情况下才会被触发? 5. 一个方法上的 `@SentinelResource` 在单元测试里"生效"、在线上却完全不生效,而线上确实有流量。列出三个最可能的原因和对应的验证手段。
预览
发布文章
添加摘要让读者更快了解文章内容
取消
确认发布
AI 写作助手
输入一个主题,AI 将为你生成一篇 Markdown 博客文章
AI 正在写作中...
取消
开始生成
AI 优化助手
描述你的修改需求,AI 将在原文基础上进行补充或微调
AI 正在优化中...
取消
开始优化
画布
从已有图里选
✕
图名
保存后生成 /images/excalidraw/<图名>.svg(只能用字母、数字、短横线、下划线、点)
取消
保存并插入