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

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

INCREX 为什么能替代两条命令

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

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

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

边界值与 TTL 怎么判断

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

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

调用方只判断两个结果

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

常见问题

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

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

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

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