Sentinel 链路流控模式配置细节：关闭context整合

什么是“链路模式”

链路模式（也叫关联模式或入口限流）是指根据资源调用链路进行限流，只针对从某个入口进入的请求进行限流，而不是对所有请求进行限流。

问题背景

1. 默认行为：Sentinel默认只将Controller中的方法标记为资源
2. context整合：Sentinel默认会将所有Controller方法整合到同一个调用上下文中
3. 问题：这导致无法区分同一个资源被不同入口调用的情况

示例场景说明

假设：

• 资源A：商品查询方法
• 入口1：用户直接访问商品详情页面
• 入口2：从订单页面跳转到商品详情

如果没有链路模式：

• 无论是从哪个入口来的请求，都会计入同一个资源统计
• 无法实现“只限制从订单页面来的商品查询，而不限制直接访问”

配置解析

1. 标记非Controller资源

@RestControllerpublicclassGoodsController{// 使用@SentinelResource注解标记资源@SentinelResource("queryGoods")publicvoidqueryGoods(){System.err.println("查询商品");}}

2. 关闭context整合

spring:cloud:sentinel:web-context-unify:false# 关键配置

3. Sentinel控制台设置

在控制台中配置流控规则时：

• 选择“链路模式”
• 指定资源名（如：queryGoods）
• 指定入口资源（如：/order/detail）

工作流程

1. 用户通过入口A访问 → 触发链路A → 应用对应的流控规则
2. 用户通过入口B访问 → 触发链路B → 应用另一套流控规则
3. 相同的资源（queryGoods）在不同链路上有独立的流控统计

实际应用场景

• 优先级控制：VIP用户入口不限流，普通用户入口限流
• 来源区分：内部系统调用不限流，外部API调用限流
• 业务隔离：促销活动入口独立限流，不影响正常业务流程

优势

• 更细粒度的流量控制
• 避免“一刀切”的限流策略
• 提升系统资源的合理分配
• 增强系统的稳定性

这就是Sentinel链路模式的核心价值：让同一个资源在不同调用链路上可以有不同的流控策略。

不过，关闭context整合并不会导致所有Controller接口都需要手动加注解才能限流。这点我澄清一下：

实际情况分析

1.关闭context整合的作用

spring:cloud:sentinel:web-context-unify:false# 只是关闭调用链路的整合

这个配置只影响链路模式的正常工作，不会影响普通限流。

2.Controller接口的默认行为

即使关闭了context整合：

• Controller中的接口仍然会被Sentinel自动监控
• 不需要加@SentinelResource注解也能进行常规限流
• 常规的QPS/线程数限流仍然有效

3.什么情况下需要加@SentinelResource？

4.实际配置示例

@RestControllerpublicclassGoodsController{// 场景1：常规限流 - 不需要注解@GetMapping("/goods/{id}")publicGoodsgetGoods(@PathVariableLongid){// 这个方法会自动被Sentinel监控// 可以在控制台配置对这个接口的QPS限流returngoodsService.getById(id);}// 场景2：链路模式 - 需要注解@SentinelResource("queryGoodsInfo")// 明确标记资源名publicGoodsDetailqueryGoodsDetail(Longid){// 这个方法被标记后，可以配置链路限流// 例如：从订单入口调用限流100，从搜索入口调用不限流returngoodsService.getDetail(id);}}

5.Sentinel的自动资源发现机制

Spring Cloud Sentinel自动发现以下资源：

• ✅所有@RequestMapping注解的方法
• ✅所有@GetMapping、@PostMapping等方法
• ✅所有Controller中的public方法

6.验证方法

你可以在Sentinel控制台看到：

1. 关闭context整合后：

   • 资源列表仍然显示所有Controller接口
   • 可以对它们配置常规流控规则

2. 链路模式配置时：

   • 只有用@SentinelResource标记的资源才能配置"关联"或"链路"模式
   • 需要指定"入口资源"和"资源名"

总结

关闭web-context-unify: false的唯一影响是：

• 让链路模式能够正常工作
• Controller接口的常规限流完全不受影响
• 只有当你需要使用链路模式这种特定流控时，才需要加@SentinelResource注解

一句话，即使关闭了context整合，Controller接口仍然会被Sentinel自动监控和保护！