因为Redis原子性仅限单命令,INCR与EXPIRE分离执行会导致竞态:INCR成功后若EXPIRE失败(如网络中断),key永久存在;并发时过期时间还被覆盖,窗口边界错乱。

为什么直接用 INCR + EXPIRE 做滑动窗口会出错
因为 Redis 的原子性只保证单个命令,INCR 和 EXPIRE 是两个独立操作,中间可能被其他客户端插入请求,导致窗口边界错乱。比如在 1 秒窗口内,你刚 INCR 到 99,还没来得及 EXPIRE,另一个客户端就进来把 key 覆盖了——这个 key 就没了过期时间,后续所有请求都算进同一个“永久窗口”,彻底失效。
必须用 Lua 脚本把判断、计数、过期设置全包在一个原子上下文中执行。
EVAL 中如何正确维护时间戳有序集合(ZSET)
滑动窗口本质是维护一个按时间排序的请求记录,用 ZSET 最合适:score 存 UNIX 时间戳(秒级或毫秒级),member 可用随机值或客户端 ID 防重复。关键点在于每次脚本执行时:先剔除窗口外旧数据,再插入新时间戳,最后返回当前窗口内总数。
- 用
ZREMRANGEBYSCORE清理score 的成员,注意单位统一(比如都用秒) - 用
ZADD插入now作为 score,避免用microseconds导致精度溢出或比较混乱 - 用
ZCARD获取当前有效请求数,不是ZCOUNT——后者要重算范围,多一次遍历 - 务必在脚本开头用
redis.call("TIME")拿服务端时间,别信客户端传的时间戳
限流脚本里怎么处理「超限后是否拒绝」的逻辑分支
很多脚本只返回计数值,业务层再判断是否超限,这会引入竞态:脚本返回 99,业务层判断未超限,但此时另一个请求进来,实际已到 100。正确做法是在 Lua 里做完判断并直接返回布尔结果。
示例片段(限制每 60 秒最多 100 次):
local key = KEYS[1]
local window = tonumber(ARGV[1]) -- 60
local limit = tonumber(ARGV[2]) -- 100
local now = tonumber(redis.call("TIME")[1])
<p>redis.call("ZREMRANGEBYSCORE", key, 0, now - window)
redis.call("ZADD", key, now, math.random(1e12))
redis.call("EXPIRE", key, window + 1) -- 防 key 残留,+1 是保险</p><p>local count = redis.call("ZCARD", key)
if count > limit then
return 0
else
return 1
end</p>
注意:EXPIRE 放在判断前,确保 key 总有生命周期;math.random 是为 member 提供唯一性,避免同一秒内多次调用被 ZADD 覆盖。
在 Python 或 Node.js 中调用时容易忽略的兼容细节
Redis 客户端对 Lua 脚本缓存和参数传递处理不一致,几个硬坑:
- Python 的
redis-py:用register_script()缓存后,调用返回的是原始 Lua 返回值(如1或0),不是布尔型,需显式转bool(ret) - Node.js 的
ioredis:evalsha失败时默认抛异常,得手动捕获并 fallback 到eval,否则上线后首次调用必挂 - 所有客户端传
ARGV时,数字必须是字符串(如"60"),Lua 里再tonumber(),否则ZREMRANGEBYSCORE会静默失败 - 如果用集群模式,key 必须带
{}标签确保路由到同一 slot,比如"rate_limit:{user_123}"
滑动窗口真正的复杂点不在脚本本身,而在于时间精度取舍(秒 vs 毫秒)、ZSET 内存增长控制(要不要定期 ZREMRANGEBYRANK 截断长度)、以及和业务错误码的耦合方式——这些不写进脚本,就得靠外围兜底。











