什么是“链路模式”链路模式也叫关联模式或入口限流是指根据资源调用链路进行限流只针对从某个入口进入的请求进行限流而不是对所有请求进行限流。问题背景默认行为Sentinel默认只将Controller中的方法标记为资源context整合Sentinel默认会将所有Controller方法整合到同一个调用上下文中问题这导致无法区分同一个资源被不同入口调用的情况示例场景说明假设资源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工作流程用户通过入口A访问 → 触发链路A → 应用对应的流控规则用户通过入口B访问 → 触发链路B → 应用另一套流控规则相同的资源queryGoods在不同链路上有独立的流控统计实际应用场景优先级控制VIP用户入口不限流普通用户入口限流来源区分内部系统调用不限流外部API调用限流业务隔离促销活动入口独立限流不影响正常业务流程优势更细粒度的流量控制避免“一刀切”的限流策略提升系统资源的合理分配增强系统的稳定性这就是Sentinel链路模式的核心价值让同一个资源在不同调用链路上可以有不同的流控策略。不过关闭context整合并不会导致所有Controller接口都需要手动加注解才能限流。这点我澄清一下实际情况分析1.关闭context整合的作用spring:cloud:sentinel:web-context-unify:false# 只是关闭调用链路的整合这个配置只影响链路模式的正常工作不会影响普通限流。2.Controller接口的默认行为即使关闭了context整合Controller中的接口仍然会被Sentinel自动监控不需要加SentinelResource注解也能进行常规限流常规的QPS/线程数限流仍然有效3.什么情况下需要加SentinelResource场景是否需要注解说明常规限流❌ 不需要Controller方法自动被Sentinel识别链路模式限流✅ 需要需要明确标记资源名称降级规则✅ 需要需要明确标记资源进行熔断降级热点参数限流✅ 需要需要明确标记资源系统规则❌ 不需要系统级别的不依赖具体资源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控制台看到关闭context整合后资源列表仍然显示所有Controller接口可以对它们配置常规流控规则链路模式配置时只有用SentinelResource标记的资源才能配置关联或链路模式需要指定入口资源和资源名总结关闭web-context-unify: false的唯一影响是让链路模式能够正常工作Controller接口的常规限流完全不受影响只有当你需要使用链路模式这种特定流控时才需要加SentinelResource注解一句话即使关闭了context整合Controller接口仍然会被Sentinel自动监控和保护