Redis 键空间通知为什么收不到过期事件

Redis 键已经设置 TTL，但订阅端始终收不到 expired，先不要把问题归到客户端库。最常见的原因有三个：notify-keyspace-events 没有同时启用频道类型和 x 事件类别；订阅了错误的数据库编号或频道格式；键虽然到期，却还没有被 Redis 实际删除。

最小判断标准：监听 keyevent 过期事件可使用 Ex，并订阅 __keyevent@0__:expired。其中 E 选择 keyevent 频道，x 选择 expired 事件，0 必须换成键所在的数据库编号。

先检查配置字符和订阅频道

键空间通知默认关闭。仅写 x 不够，因为它只选择事件类别；还需要 E 或 K 指定发布到哪类频道。Ex 表示在 keyevent 频道发布过期事件，Kx 表示在 keyspace 频道发布过期事件。排障时不建议一开始就使用覆盖面很大的 KEA，最小配置更容易确认边界。

# 查看当前通知配置；空字符串表示通知仍处于关闭状态。
redis-cli CONFIG GET notify-keyspace-events

# 只启用 keyevent 频道和 expired 事件类别。
redis-cli CONFIG SET notify-keyspace-events Ex

# 订阅 0 号库的过期事件；消息正文会是发生过期的键名。
redis-cli PSUBSCRIBE '__keyevent@0__:expired'

如果使用 keyspace 频道，订阅表达式会换成具体键名或通配符，例如 __keyspace@0__:order:*，此时消息正文是事件名称 expired。如果使用 keyevent 频道，频道名称里是事件，消息正文才是键名。两类频道含义相反，混用时看起来就像“什么都没有收到”。

不要把 expire 和 expired 当成同一个事件

expire 表示某个过期时间已经被设置到键上；expired 表示到期键已经被 Redis 删除。前者在设置 TTL 时产生，后者要等到键真正消失。只订阅 expired 时，执行 EXPIRE 的那一刻没有收到目标事件是正常现象。

# 创建一个带 5 秒过期时间的测试键，避免把生产键状态带入排查。
redis-cli SET notice:test value EX 5

# 查看剩余 TTL，确认测试键确实带有过期时间。
redis-cli TTL notice:test

测试时还要注意一个容易忽略的边界：如果把过期时间设成负数，或使用已经过去的绝对时间，Redis 会直接删除键，并生成 del 事件，而不是 expired 事件。此时继续等待过期通知不会有结果。

配置正确，事件仍可能晚于 TTL 归零

Redis 不保证在 TTL 变成 0 的同一毫秒发送 expired。事件是在键真正被删除时产生；删除可能由后台过期检查触发，也可能在客户端再次访问该键时触发。因此，系统负载、过期键数量和检查节奏都会让通知稍晚出现。

这也意味着，业务不能把键空间通知当成精确计时器。如果任务必须在某个时刻可靠执行，应使用有持久化、确认或补偿能力的任务机制；键空间通知更适合缓存失效提示、监控和辅助联动。

再检查 Pub/Sub 连接和集群节点

键空间通知通过 Redis Pub/Sub 发送。Pub/Sub 是即时投递：订阅客户端断线期间的消息不会在重连后补发。若服务发生过重启、网络切换或连接池回收，应先确认订阅连接是否一直存活，以及重连后是否重新执行了订阅。

Redis Cluster 还有一个节点边界：每个节点只发布自己产生的键空间通知。只连接一个节点，无法自动收到其他节点上键的事件。需要覆盖整个集群时，订阅端必须连接并订阅每个相关节点，同时处理节点拓扑变化。

快速排查清单

• CONFIG GET notify-keyspace-events 的结果是否包含 x，并且至少包含 E 或 K。
• 订阅的是 keyevent 还是 keyspace 频道，是否按对应语义读取消息正文。
• 频道中的数据库编号是否与目标键所在数据库一致。
• 键是否真的带 TTL，过期时间是否不是负数或过去时间。
• 是否给实际删除留出了合理时间，而不是要求 TTL 归零瞬间到达。
• 订阅连接是否断开过，重连后是否重新订阅。
• 在集群模式下，是否订阅了保存目标键的节点以及其他需要覆盖的节点。

常见问题

只配置 x 为什么仍然收不到？ 因为 x 只选中了过期事件类别，没有选择 E 或 K 频道，通知仍不会发布。

Ex 和 Kx 哪个更适合全局监听？ 通常使用 Ex，因为可以固定订阅 __keyevent@数据库编号__:expired，再从消息正文读取键名；Kx 更适合围绕指定键模式监听。

生产环境可以直接开 KEA 吗？ 可以开启较宽事件集合，但会增加发布量。排障时先用 Ex 缩小范围，确认需求后再决定是否扩展。

按“配置字符、频道格式、数据库编号、删除时机、连接状态、集群节点”六项依次核对，绝大多数收不到 Redis 过期事件的问题都能快速定位。