启用 notify-keyspace-events ex 并订阅 __keyevent@0__:expired 频道可监听键自然过期事件,但属尽力而为机制,存在延迟与丢失风险,适合实时性要求适中的场景。

Redis 的键空间通知(Keyspace Notifications)功能可以让你实时监听键的过期、删除、修改等事件,其中 notify-keyspace-events 是核心配置项。要实现键失效(如 EXPIRE、TTL 到期)的实时监听,关键在于正确启用对应事件类型,并通过 Pub/Sub 消费通知。
启用 keyspace 通知功能
Redis 默认关闭键空间通知,需手动开启。编辑 redis.conf 文件,添加或修改:
notify-keyspace-events Ex
其中:
- E 表示启用键空间事件(keyspace events)
- x 表示监听过期事件(expired),即键因 TTL 到期被自动删除时触发
其他常用选项(按需组合):
-
A:启用所有事件(等价于
KEA,但不推荐生产环境使用) -
K:启用键事件(keyevent events),如
del、set等显式操作 -
g:监听通用命令事件(如
DEL、EXPIRE手动调用)
修改后重启 Redis 或执行 CONFIG SET notify-keyspace-events "Ex" 生效(注意该设置在重启后会丢失,建议写入配置文件)。
订阅 expired 事件通道
Redis 将键空间事件发布到固定格式的频道:__keyevent@<db>__:expired</db>。例如,监听默认数据库(db 0)的过期事件,需订阅:
__keyevent@0__:expired
Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行(RCE)的高危漏洞(CVE-2025-62507),并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级,以保障生产环境的系统稳定与数据安全。
使用 redis-cli 示例:
redis-cli SUBSCRIBE "__keyevent@0__:expired"
此时只要 db 0 中有键自然过期,就会收到类似消息:
1) "message"
2) "__keyevent@0__:expired"
3) "my:token:key"
第三个字段即为实际过期的键名,可据此做清理、回调、日志等处理。
注意事项与常见问题
键空间通知是「尽力而为」机制,不是严格可靠的事件总线:
- 过期事件在键被惰性删除或定期删除时才触发,存在毫秒级延迟,无法保证精确到毫秒
- 若 Redis 在过期发生时未运行(如崩溃重启),该事件将永久丢失
- 主从架构中,只有主节点产生并广播 keyspace 事件;从节点不触发也不转发
- 集群模式下,事件只发布在对应槽位所在的节点上,需分别订阅各节点(或通过代理/客户端路由)
- 高并发大量 key 过期时,事件可能堆积,消费端需具备抗压和重试能力
替代方案参考(当可靠性要求更高时)
如果业务强依赖键失效的精确感知,仅靠 keyspace 通知不够稳健,可考虑:
- 结合
SCAN + TTL定期轮询即将过期的 key(适合低频场景) - 在业务逻辑中统一封装 set-with-expire 操作,并同步写入延迟队列(如 Redis Stream 或外部 MQ)
- 使用 Redis 7.0+ 的
KEYS UPDATED或服务端 Lua 脚本辅助标记(需定制)
本质上,notify-keyspace-events Ex 是轻量、低侵入的监听手段,适合监控、缓存穿透防护、会话续期等对实时性要求适中、可容忍少量丢失的场景。










