流量控制：解密 Sentinel 热点参数限流与高频 Key 探测原理

在微服务架构的高并发核心场景（如秒杀系统）中，我们往往会面临突发的“热点请求”。例如：全网 99% 的请求都在疯抢某个特定的热卖商品（如 goodsId = 10001），而其他普通商品（如 goodsId = 10002）的请求却寥寥无几。

如果强行对整个接口进行粗粒度的 QPS 限流，会导致抢购普通商品的正常用户被无辜误杀。为了实现**“只针对少数爆款商品限流，而放行绝大多数普通商品”**，我们必须引入**热点参数限流（Param Flow Control）**。

本文将系统拆解 Alibaba Sentinel 热点限流的内存 LRU 队列热点探测、基于参数令牌桶的秒级控流、以及 Java 热点降级配置实战。

一、 核心概念：热点限流与普通流控的对比

热点参数限流在维度粒度、内存消耗及动态识别上均做出了针对性升级：

二、 Sentinel 热点探测与参数限流流转拓扑

当一个包含商品 ID 字段的买单请求流经 Sentinel 哨兵时，其热点校验拓扑如下：

      [ 业务请求: buyGoods(goodsId = 10001) ]
                        │
                        ▼ 1. 拦截并进入 ParamFlowSlot 插槽
         [ 核心过滤器: ParamFlowSlot ] ◄── 读取规则定义的参数索引 (如 index = 0)
                        │
                        ▼ 2. 提取参数值 "10001"，查询热点缓存
       [ 内存 LRU 统计队列 (ParameterMetric) ]
                        │
                        ├─ 3. 将 "10001" 放入 LRU 队列头部并累加计数
                        │
                        ▼ 4. 判定是否命中例外项配置 (ParamFlowRule.paramFlowItemList)
             【 goodsId == 10001 ？ 】
                        │
            ┌───────────┴───────────┐
         (是)                    (否)
            ▼                       ▼
     [ 5a. 匹配例外项 QPS ]   [ 5b. 适用全局参数 QPS 阈值 ]
     (如: 限制 QPS = 5)       (如: 限制 QPS = 100)
            │                       │
            └───────────┬───────────┘
                        │
                        ▼ 6. 核心令牌桶校验其是否超出限制
             【 参数级令牌桶内令牌数是否足够 ？ 】
                        │
              ┌─────────┴─────────┐
            (是)                 (否)
              ▼                   ▼
       [ 直接放行写入 ]     [ 7. 触发拦截，抛出 ParamFlowException ]

三、 代码实战：声明方法级热点参数流控

以下代码展示了如何利用 Sentinel 的 @SentinelResource 声明需要防护的热点参数方法，并通过硬编码方式设定特定商品的限流例外值：

1. 领域/应用层：带有 @SentinelResource 注解的方法

package com.company.infra.sentinel.service;

import com.alibaba.csp.sentinel.annotation.SentinelResource;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import org.springframework.stereotype.Service;

@Service
public class ProductApplicationService {

    /**
     * 秒杀购买方法：goodsId 作为第 1 个参数，索引为 0
     */
    @SentinelResource(value = "buyProductResource", blockHandler = "handleBuyBlock")
    public void buyProduct(String goodsId, int quantity) {
        System.out.println("[Sentinel Success] 成功下单商品: " + goodsId + ", 数量: " + quantity);
    }

    /**
     * 热点触发后的降级回执
     */
    public void handleBuyBlock(String goodsId, int quantity, BlockException ex) {
        System.err.println("[Sentinel Blocked] 触发热点限流！商品: " + goodsId + " 处于抢购高峰，请稍后重试！");
    }
}

2. 规则注入层：配置热点例外项规则

package com.company.infra.sentinel.config;

import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowItem;
import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowRule;
import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowRuleManager;
import org.springframework.context.annotation.Configuration;
import javax.annotation.PostConstruct;
import java.util.*;

@Configuration
public class SentinelParamFlowConfiguration {

    @PostConstruct
    public void initParamFlowRules() {
        ParamFlowRule rule = new ParamFlowRule("buyProductResource");
        
        // 1. 设置限流维度：针对索引为 0 的参数（即第一个参数 goodsId）
        rule.setParamIdx(0);
        
        // 2. 限流模式：QPS 维度
        rule.setGrade(RuleConstant.FLOW_GRADE_QPS);
        
        // 3. 全局默认阈值：每个商品默认限制 QPS 为 100
        rule.setCount(100);
        
        // 4. 精确例外项配置：为特定爆款商品（ID: "10001"）单独施加严苛限制，只允许 QPS = 5
        ParamFlowItem specialItem = new ParamFlowItem();
        specialItem.setObject("10001"); // 指定参数值
        specialItem.setClassType(String.class.getName()); // 参数类型
        specialItem.setCount(5); // 专属例外阈值
        
        rule.setParamFlowItemList(Collections.singletonList(specialItem));
        
        // 将热点规则装入管理器
        ParamFlowRuleManager.loadRules(Collections.singletonList(rule));
        System.out.println("[Sentinel] 热点参数限流例外项规则成功初始化完毕！");
    }
}

四、 总结

Sentinel 的热点参数限流与内存 LRU 队列统计机制，是保障微服务应对倾斜流量和防范恶意刷单的“微米级手术刀”。

It 通过**基于 LRU 队列的高频 Key 自动识别，完美规避了内存被海量非热点参数撑爆的弊端，达成了空间与效率的最优解；并结合参数级例外项（Exceptions）弹性配置，做到了对爆款商品与普通商品的灰度精细化限流分控**。掌握这套热点参数控制规则与 @SentinelResource 自定义降级装配，是打造高性能云原生大促防御系统 of 核心看家本领！