Redis 与缓存 / 系统课时
实现固定窗口限流
实现固定窗口限流
本课解决某个用户或接口在固定时间内最多允许多少次请求的问题。你将用 Redis 计数器和 Lua 构建原子限流器,并识别窗口交界处可能出现的瞬时突发。
学习目标
- 理解固定窗口的计数方式
- 使用 Lua 原子递增计数并设置 TTL
- 判断固定窗口是否满足业务的平滑性要求
固定窗口模型
固定窗口把时间切成连续区间。每个限流主体在当前窗口对应一个计数键,请求到达时计数加一;计数不超过阈值则放行,超过阈值则拒绝,窗口结束后键自动过期。

原子计数脚本
如果先 INCR、再单独设置过期时间,客户端在两条命令之间失败可能留下永久计数键。Lua 可把首次计数、设置 TTL 和阈值判断放在一次原子执行中。
lua
local current = redis.call("INCR", KEYS[1])
if current == 1 then
redis.call("EXPIRE", KEYS[1], tonumber(ARGV[2]))
end
if current <= tonumber(ARGV[1]) then
return 1
end
return 0将脚本保存为 fixed-window.lua,验证每分钟最多放行 3 次:
bash
SCRIPT="$(cat fixed-window.lua)"
WINDOW="$(($(date +%s) / 60))"
KEY="rate:login:user:1001:${WINDOW}:demo-$$"
redis-cli EVAL "$SCRIPT" 1 "$KEY" 3 60
redis-cli EVAL "$SCRIPT" 1 "$KEY" 3 60
redis-cli EVAL "$SCRIPT" 1 "$KEY" 3 60
redis-cli EVAL "$SCRIPT" 1 "$KEY" 3 60
redis-cli TTL "$KEY"预期输出:
text
(integer) 1
(integer) 1
(integer) 1
(integer) 0
<REMAINING_SECONDS>1 表示放行,0 表示拒绝。<REMAINING_SECONDS> 应为大于 0 且不超过 60 的整数,实际值会随执行耗时减少。
键设计与边界问题
键名应包含限流对象、业务动作和窗口编号,例如用户、IP、接口或租户维度。窗口编号必须由可信服务端生成,不能直接接受客户端传入,否则调用方可能绕过限制。
固定窗口在边界处不平滑:前一窗口最后一秒可放行 3 次,下一窗口第一秒又可放行 3 次。若业务要求任意连续时间段内都严格受限,应改用滑动窗口;若更关注稳定吞吐,可考虑令牌桶或漏桶。
按自己的节奏,确认真正理解。