**摘要：** 在高并发场景下，如秒杀活动，我们往往需要对特定的参数进行精细化的流量控制。Sentinel 的"热点参数限流"功能正是为此而生。本文将通过一个秒杀下单接口的实战案例，详细讲解如何配置热点参数规则，实现对不同用户、不同商品的差异化限流策略。
1. 什么是热点参数限流？
在传统的 QPS 限流中，我们通常是对整个接口（Resource）进行限流。但在实际业务中，我们可能希望对某个接口中的特定参数进行限流。
例如在秒杀场景中：
-
我们希望限制普通用户的下单频率（如每秒1次）。
-
我们希望对 VIP 用户放开限制。
-
我们希望禁止访问已下架的商品。
Sentinel 的热点参数限流（Param Flow Control）允许我们针对方法中的参数进行限流，从而实现更细粒度的流量控制。
2. 核心概念解析
在配置热点参数规则前，我们需要理解几个关键概念：
-
资源名 (Resource)：被保护的方法或接口名称。
-
参数索引 (Param Index)：方法参数列表中的索引位置（从0开始）。
-
单机阈值 (Threshold)：默认的限流阈值。
-
参数例外项 (Param Flow Item)：针对特定参数值的特殊限流规则。
3. 实战案例：秒杀接口限流配置
假设我们有一个秒杀下单接口，代码如下：
java
@GetMapping("/seckill")
@SentinelResource(value = "seckill-order", fallback = "seckillFallback")
public Order seckill(@RequestParam("userId") Long userId, @RequestParam("productId") Long productId){
Order order = orderService.createOrder(productId, userId);
order.setId(1000000000L);
return order;
}我们需要实现以下三个需求：
-
需求1：每个用户秒杀 QPS 不得超过 1（基于 userId 限流）。
-
需求2：6号用户是 VIP，不限制 QPS。
-
需求3：666号是下架商品，不允许访问。
3.1 配置基础规则
首先，我们在 Sentinel 控制台新增热点规则。
-
资源名 ：
seckill-order -
限流模式：QPS 模式
-
参数索引 ：
0（对应userId参数）并且只有携带此参数的才参与流控 不携带则不参与 -
单机阈值 ：
1（普通用户每秒最多1次请求） -
统计窗口时长 ：
1秒
3.2 配置参数例外项（VIP用户）
接下来，我们需要为 VIP 用户（userId=6）配置例外规则。
-
点击"新增参数例外项"。
-
参数类型 ：
long -
参数值 ：
6 -
限流阈值 ：
1000000（设置一个极大的值，相当于不限流）
3.3 配置参数例外项（下架商品）
-
修改参数索引 ：
1（对应productId参数） -
单机阈值 ：
100000（默认允许大量请求） -
参数例外项：
-
参数值 ：
666 -
限流阈值 ：
0（阈值为0表示直接拒绝访问）
-
4. 代码逻辑与降级处理
为了保证服务的健壮性，我们使用了 @SentinelResource注解并指定了降级方法。
java
public Order seckillFallback(Long userId, Long productId, Throwable e){
System.out.println("进入fallback");
Order order = new Order();
order.setAddress("异常信息" + e.getClass());
return order;
}当请求被 Sentinel 限流或发生异常时，会自动调用 seckillFallback方法，返回一个包含异常信息的默认订单，避免接口直接报错。
5. 总结
Sentinel 的热点参数限流功能极大地增强了我们对流量的控制能力。通过结合基础规则 和参数例外项，我们可以轻松实现：
-
差异化限流：针对不同用户群体设置不同的限流策略。
-
黑名单/白名单：通过设置阈值为0或极大值，实现对特定参数的封禁或放行。
-
精细化控制：不再局限于对整个接口的粗粒度限流，而是深入到业务参数层面。
掌握这一功能，对于构建高可用、高并发的分布式系统至关重要。