滑动窗口不能只用ZCOUNT因它无法处理毫秒级精度、同一秒内多请求去重及动态权重计算,仅实现近似固定窗口;INCR+EXPIRE则因无时间轨迹而无法滑动;真滑动窗口需ZAdd+ZRemRangeByScore+Lua原子封装。

滑动窗口为什么不能只用 ZSET 的 ZCOUNT 算总数
很多人一想到滑动窗口,就直接用 ZSET 存时间戳,然后每次请求执行 ZCOUNT key min max 判断是否超限。这在低并发下看似可行,但实际会出问题:ZCOUNT 只能统计范围内的元素个数,无法区分“同一秒内多个请求”是否该合并计数(比如 1 秒限 10 次,但用户在 10ms 内发了 10 个请求,ZCOUNT 会放行全部,而真实滑动窗口应按时间偏移加权衰减)。
更关键的是:Redis 的 ZSET 不支持对每个 score 做毫秒级精度的动态权重计算,也没有内置的滑动窗口聚合函数。纯靠 ZCOUNT 实现的只是“近似滑动窗口”,本质是固定窗口 + 尾部模糊覆盖,不是 RFC 6585 定义的严格滑动窗口。
INCR + EXPIRE 组合为什么撑不住滑动窗口
用 INCR key 配合 EXPIRE key window_sec 是最简限流,但它只能实现固定时间窗口(如“每 60 秒最多 100 次”),窗口边界硬切——00:00:00–00:00:59、00:01:00–00:01:59……用户在 00:00:59.9 发第 100 次,00:01:00.1 立刻又能发 100 次,完全绕过限制。
这个方案的问题在于:它没有维护任何时间维度的请求轨迹,丢失了“滑动”所需的上下文。哪怕你把 key 设计成 rate:uid:202405010001(按分钟分桶),也只是把固定窗口切得更细,依然不是滑动的。
立即学习“go语言免费学习笔记(深入)”;
Go 中用 redis.ZAdd + redis.ZRemRangeByScore 实现真滑动窗口
核心思路是:每个请求以毫秒时间戳为 score 写入 ZSET,同时清理过期项(score ),再用 <code>ZCARD 获取当前窗口内请求数。必须注意三个细节:
- score 必须用毫秒时间戳(
time.Now().UnixMilli()),不能用秒,否则同一秒内多次请求 score 相同,ZSET会去重(除非显式加唯一 member 后缀) - 清理操作
ZRemRangeByScore key -inf (now - window_ms)要放在ZCARD之前,且使用(表示开区间,避免刚好卡在边界的时间点被误删 - 整个操作需原子性,推荐用 Lua 脚本封装,避免客户端先删后查导致竞态(比如 A 删完、B 插入、A 再查,漏计 B 的请求)
一个最小可用 Lua 脚本示例:
local key = KEYS[1]
local now = tonumber(ARGV[1])
local window_ms = tonumber(ARGV[2])
local max_count = tonumber(ARGV[3])
<p>redis.call('ZREMRANGEBYSCORE', key, '-inf', '(' .. (now - window_ms))
local current = redis.call('ZCARD', key)
if current < max_count then
redis.call('ZADD', key, now, ARGV[4])
redis.call('PEXPIRE', key, window_ms + 1000)
end
return current + 1Go 调用时传入 key、now.UnixMilli()、windowMs、maxCount 和唯一 member(如请求 ID 或 fmt.Sprintf("%d:%d", now, rand.Intn(1000)))即可。
高并发下要注意 ZCARD 性能和内存膨胀
ZCARD 是 O(1),但 ZREMRANGEBYSCORE 是 O(log(N)+M),其中 M 是删除元素个数。如果窗口长(如 1 小时)、QPS 高(如 1w+),ZSET 可能堆积几十万成员,每次清理耗时波动大,甚至触发 Redis 主线程阻塞。
缓解方式有三个:
- 缩短滑动窗口时长(如从 3600s 改为 60s),用更细粒度的窗口 + 多层限流兜底
- 给 key 加
PEXPIRE(比窗口多留 1s),避免 ZSET 永久驻留;但注意:如果清理不及时,过期时间可能被新写入刷新,需确保脚本里PEXPIRE在ZADD后执行 - 不用
ZSET,改用 Redis 6.2+ 的TS.ADD时间序列模块(需开启 RedisTimeSeries 模块),天然支持滑动窗口聚合,但 Go 客户端支持尚不统一
真正上线前,务必用 redis-cli --intrinsic-latency 10 测延迟,并在压测中观察 INFO commandstats 里 cmdstat_zremrangebyscore 的调用耗时分布。


















