直接用INCR+EXPIRE会出错因二者非原子操作:若INCR成功但EXPIRE失败(如连接中断),key永久存在致限流失效;高并发下多客户端同时设EXPIRE还会覆盖TTL。

为什么直接用 INCR + EXPIRE 会出错
因为这两条命令不是原子的:如果 INCR 成功但 EXPIRE 失败(比如 Redis 连接中断、主从切换),key 就会永久存在,导致后续所有限流判断失效。更隐蔽的问题是,在高并发下,多个客户端可能同时发现 key 不存在,各自执行 INCR 和 EXPIRE,最终 key 的过期时间被反复覆盖,实际 TTL 缩短甚至丢失。
用 Lua 脚本保证“创建+设过期+计数”三步原子性
Lua 脚本在 Redis 中以原子方式执行,适合封装带逻辑的限流操作。关键点在于:按分钟分片,即每个请求的 key 要包含当前分钟戳(如 "rate:uid123:202405211430"),避免跨分钟污染。
- 脚本接收三个参数:
KEYS[1](完整 key)、ARGV[1](最大请求数)、ARGV[2](TTL,固定为 60 秒) - 先
INCR,再检查是否为 1(说明是本分钟首次请求),若是则EXPIRE - 返回当前计数值,由客户端判断是否超限
local current = redis.call("INCR", KEYS[1])
if current == 1 then
redis.call("EXPIRE", KEYS[1], ARGV[2])
end
return current
客户端构造 key 时必须对齐分钟边界
不能直接用 new Date().toISOString() 或 strftime("%Y%m%d%H%M"),否则本地时间与 Redis 服务器时间不一致会导致分片错乱。必须用 TIME 命令或服务器时间戳对齐。
- 推荐做法:客户端先执行
TIME获取 Redis 服务端秒级时间戳,计算对应分钟起点(ts - ts % 60),再拼成 key - 错误示例:
"rate:uid123:" .. os.date("%Y%m%d%H%M")(本地时区/时钟偏差会引发漏限或误限) - Java 示例中应调用
jedis.time()而非System.currentTimeMillis()
注意 EVALSHA 缓存和脚本长度限制
频繁调用 EVAL 开销大,建议预加载脚本并用 EVALSHA 执行。但 Redis 对单个 Lua 脚本有 512MB 内存限制(实际远小于此),而频率限制脚本本身极轻量,真正容易踩坑的是 key 名过长或嵌套逻辑。
- 确保 key 总长度 ≤ 1024 字符,尤其当 uid 含 Base64 或 UUID 时要截断或哈希
- 不要在脚本里做条件 sleep、循环重试或调用
redis.call("KEYS", ...)—— 这些会阻塞 Redis 单线程 - 如果需支持“滑动窗口”,此脚本不适用;它只适合“固定窗口”,且窗口粒度严格绑定分钟对齐
分片逻辑和时间对齐一旦写错,问题往往延迟暴露——比如凌晨跨天时本地时间比 Redis 快 2 秒,就会让一部分请求落到上一分钟的 key,另一部分落到下一分钟,造成统计断裂。这类 bug 很难复现,务必在测试环境用 NTP 同步时间后验证。











