Redis如何监听Key过期事件

Redis的Key过期事件监听并非实时精准的定时机制，而是在键被实际删除时才异步发布`__keyevent@0__:expired`消息，存在毫秒至秒级延迟，且不保证100%送达——尤其在内存压力大、客户端断连或Pub/Sub缓冲区满时事件会静默丢失；必须显式启用`notify-keyspace-events Ex`配置（禁用宽泛组合以防性能雪崩），Spring Boot需正确配置`RedisMessageListenerContainer`并严格指定数据库编号的完整频道名，原生客户端还需隔离订阅连接并自行实现断线重连；更关键的是，若启用了LRU等内存淘汰策略，过期键可能被“驱逐”而非“自然过期”，此时触发的是`e`事件而非`x`，未配置`Eex`将彻底漏收——因此，任何依赖该事件的关键业务（如订单关单）都必须搭配定时扫描+状态校验的兜底方案，绝不可将其当作可靠时钟使用。

Redis过期事件监听不是实时触发，而是“删除时通知”

Redis的__keyevent@0__:expired消息不是在TTL归零那一刻发出的，而是在键**被真正删除时**才发布——这可能延迟几毫秒到几秒，尤其在内存压力大、使用惰性删除+定期删除混合策略时。这意味着你不能把它当成精确计时器用，比如“订单30分钟整准时关单”这种需求，实际关闭时间可能晚于30分钟。

• Redis不保证过期事件100%送达：若订阅客户端断连、消息积压或Pub/Sub缓冲区满，事件会直接丢失（无重发机制）
• 事件只带key名，不带value、过期时间、数据库编号以外的任何上下文
• 如果你依赖该事件做关键业务（如支付关单），必须配合兜底机制（例如定时扫描+状态校验）

必须开启 notify-keyspace-events 配置，且仅限 Ex 或 AKE

默认情况下，Redis完全不发送任何键空间事件。光改代码没用，notify-keyspace-events这个配置项必须显式启用，否则__keyevent@0__:expired频道永远收不到消息。

• 最小安全配置是 notify-keyspace-events Ex：E 表示 keyevent 类型，x 表示 expired 事件
• 别用 AKE 或 gxE 等宽泛组合——它会广播 del、expire、rename 等所有操作，大幅增加网络和CPU开销，尤其在高写入场景下容易压垮监听服务
• 修改后需重启 Redis 或执行 CONFIG SET notify-keyspace-events "Ex"（注意：该命令在部分云托管Redis中被禁用）

Spring Boot 中监听需配 RedisMessageListenerContainer + TopicPattern

Spring Data Redis 的 RedisMessageListenerContainer 默认不自动订阅过期事件，必须手动注册监听器并指定频道模式。直接 new 一个 MessageListener 并扔进去是无效的。

• 频道名必须严格为 __keyevent@0__:expired（数字0替换成你的目标db编号）；不能写成 __keyevent@*:expired —— Redis 不支持通配符订阅跨库事件
• 如果要用正则匹配 key 名（例如只处理 order:* 过期），得在 onMessage 回调里自己做 key.startsWith("order:") 判断，Redis 层不提供 pattern-filtering
• 监听器 Bean 必须声明为 @Component 或通过 @Bean 注入容器，且 container.setConnectionFactory(...) 后必须调用 container.afterPropertiesSet()（Spring Boot 2.4+ 自动处理，但低版本需显式）

Jedis/Redisson 直连方式要注意连接隔离与重连逻辑

用原生 Jedis 或 Redisson 手动 subscribe 时，最容易出问题的是连接生命周期管理——Pub/Sub 连接不能复用普通命令连接，且断线后不会自动重订阅。

• Jedis：必须用独立的 JedisPubSub 实例 + 单独的 Jedis 订阅连接，不能拿 JedisPool 里的连接去 subscribe（会阻塞整个连接池）
• Redisson：要用 getPatternTopic("*") 而非 getTopic("__keyevent@0__:expired")，否则无法收到消息；且必须主动调用 addListener 并确保 listener 实现 PatternMessageListener
• 所有直连方案都得自己实现断线重连 + 重订阅逻辑，否则一次网络抖动就永久失联

最常被忽略的一点：过期事件只在键被删除时触发，而 Redis 删除键的时机不可控。如果你的实例设置了 maxmemory + allkeys-lru，那么一个 key 可能因内存驱逐被删，此时发的是 e 事件（not x），除非你把 notify-keyspace-events 配成 Eex，否则根本收不到通知。

理论要掌握，实操不能落！以上关于《Redis如何监听Key过期事件》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！