首页 > 数据库 > Redis

Redis 8.8 INCREX 限流为什么不再拆两条命令：边界值与 TTL 判断

来源：17golang原创

时间：2026-09-01 17:42:47 348浏览收藏

固定窗口限流常见的坑，不是计数不会加，而是计数与过期时间分成两次操作：中间失败会留下没有 TTL 的键。Redis 8.8 新增 INCREX，把增量、上下界和过期策略放进同一条原子命令，调用方只需读懂返回的“新值”和“实际增量”。

要点速览

INCREX 从 Redis Open Source 8.8.0 开始提供，时间复杂度为 O(1)。
UBOUND 限制上界，达到上限后实际增量可返回 0。
ENX 只在键当前没有 TTL 时设置过期，避免每次请求都延长窗口。

INCREX 为什么能替代两条命令

传统写法通常先增加请求计数键，再设置过期时间。两个动作即使放进业务代码的相邻两行，也不是一个 Redis 原子操作。INCREX 把请求计数键、增量、边界与 TTL 合并处理，并返回由“新值”和“实际增量”组成的数组。

INCREX rate:user:42 BYINT 1 UBOUND 100 EX 60 ENX

命令内部的静态关系可以简化成：请求计数键交给 INCREX，结果返回新值与实际增量。业务层不必再补一次读取来判断本次是否真正放行。

Redis 8.8 INCREX 限流命令的计数与返回值结构图 — 图1：查看请求计数键、INCREX、新值与实际增量之间的关系，判断本次请求是否真正增加了计数。

边界值与 TTL 怎么判断

假设窗口上限是 UBOUND 100。未使用 SATURATE 时，越界增量会被拒绝，结果保留当前值并让 actual_incr = 0；调用方看到第二个值为 0，就可以执行限流分支。使用 SATURATE 时，结果会贴近边界，适合允许部分增量的计数场景，但接口请求通常更关心“放行或拒绝”，不要机械开启。

ENX 的作用是 TTL 不延长：只有键没有过期时间时才设置 EX 60。它必须和 EX、PX、EXAT 或 PXAT 之一组合，不能与 PERSIST 同用。

Redis 8.8 INCREX 上界返回值与 TTL 关系图 — 图2：查看 UBOUND 100、actual_incr = 0、ENX 与 TTL 不延长的关系，判断限流拒绝和窗口是否稳定。

调用方只判断两个结果

可见结果	含义	处理建议
实际增量为 1	本次计数成功	继续处理请求
实际增量为 0	触及边界或增量未应用	返回限流响应
键类型错误	现有值不是可解析数字	先检查键命名和写入来源

迁移前先确认服务端版本和客户端是否能读取数组返回值。旧版本环境不要直接发送该命令；混合版本集群也应完成兼容检查后再切流。官方命令页给出了完整语法和参数组合，可作为上线前核对依据。

常见问题

INCREX 会自动创建不存在的键吗？

会。键不存在时以 0 为初始值，再应用本次增量和过期策略。

每次请求都带 EX 60 会滑动续期吗？

配合 ENX 时不会；已有 TTL 的键不会被本次命令重新设置过期时间。

限流 TTL Redis 8.8 INCREX UBOUND Redis 限流缓存设计

声明：本文转载于：17golang原创如有侵犯，请联系study_golang@163.com删除