因为INCR/INCRBY无法原子性判断加权后是否超限,必须用Lua脚本将读值、判断、写值、设过期锁死为一次执行,确保并发安全。

为什么直接用 INCR + EXPIRE 做不了带权重的限流
因为单次请求的消耗量不固定——比如上传大文件要扣 5 点配额,查用户信息只扣 1 点。而 INCR 只能加 1,INCRBY 虽能加任意整数,但无法原子性地判断「加完后是否超限」,中间可能被其他客户端并发修改。必须用 Lua 脚本把「读当前值 → 判断 → 写新值 → 设过期」锁死在一次 Redis 执行中。
EVAL 脚本里怎么安全计算剩余配额
核心是用 redis.call("GET", KEYS[1]) 读当前计数,转成数字后叠加权重,再跟阈值比。注意三个细节:
- 如果 key 不存在,
GET返回nil,Lua 里不能对nil做算术,得用tonumber(val) or 0 - 必须用
redis.call("SET", KEYS[1], new_val, "EX", ARGV[2])一次性设值+过期,不能分开调用SET和EXPIRE,否则原子性破坏 - 阈值(
ARGV[1])和窗口秒数(ARGV[2])必须从外部传入,别硬编码在脚本里,方便复用
示例脚本逻辑:
local current = tonumber(redis.call("GET", KEYS[1])) or 0
local weight = tonumber(ARGV[1])
local limit = tonumber(ARGV[2])
local expire_sec = tonumber(ARGV[3])
if current + weight <h3>客户端调用时 KEY 和 ARGV 怎么组织才不踩坑</h3><p>KEY 必须带业务上下文前缀,避免不同服务共用同一个 key 导致误限流,比如用 <code>"rate:upload:user_123"</code> 而不是单纯 <code>"user_123"</code>。ARGV 顺序要严格对应脚本里的 <code>ARGV[1]</code>、<code>ARGV[2]</code>……建议封装成函数,别手写 <code>EVAL</code> 命令:</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill11046" title="Sentinal Redis"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="Sentinal Redis" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill11046" title="Sentinal Redis" class="overflowclass">Sentinal Redis</a>
<p class="overflowclass">监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。</p>
</div>
<a rel="nofollow" href="/xiazai/skill11046" title="Sentinal Redis" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
-
KEYS[1]:唯一限流标识(如"rate:api:/order/create:uid_456") -
ARGV[1]:本次请求权重(如文件大小 / 1024,向下取整) -
ARGV[2]:总阈值(如 100 次/分钟) -
ARGV[3]:窗口秒数(如 60)
Python 示例(redis-py):
script = redis.register_script(lua_script)
result = script(keys=["rate:upload:uid_789"],
args=[5, 20, 60]) # 权重5,上限20,60秒窗口
if result == 1:
# 通过
else:
# 拒绝
为什么不用 RedisTimeSeries 或 RediSearch 替代
它们确实支持更复杂的滑动窗口,但引入新模块会增加运维成本,且多数场景下「固定窗口 + 权重」已够用。真正要注意的是:Lua 脚本执行时间不能超过 lua-time-limit(默认 5 秒),所以脚本里别做循环或正则;另外,如果权重是浮点数(如 0.3),Redis 的 INCRBY 不支持小数,得自己用 HINCRBYFLOAT 配合 hash 结构,但会多一次 key 查找,性能略降——这时候不如把单位换算成整数(比如权重 * 10)。










