因为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 <= limit then
redis.call("INCRBY", KEYS[1], weight)
redis.call("EXPIRE", KEYS[1], expire_sec)
return 1
else
return 0
end客户端调用时 KEY 和 ARGV 怎么组织才不踩坑
KEY 必须带业务上下文前缀,避免不同服务共用同一个 key 导致误限流,比如用 "rate:upload:user_123" 而不是单纯 "user_123"。ARGV 顺序要严格对应脚本里的 ARGV[1]、ARGV[2]……建议封装成函数,别手写 EVAL 命令:
-
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)。


















