
Redis 本身不支持直接在键过期时执行自定义逻辑,但可通过启用 notify-keyspace-events 配置并结合 Pub/Sub 订阅 __keyevent@0__:expired 通道,实现在键过期时异步触发额外动作(如日志记录、数据库清理或回调通知)。
redis 本身不支持直接在键过期时执行自定义逻辑,但可通过启用 `notify-keyspace-events` 配置并结合 pub/sub 订阅 `__keyevent@0__:expired` 通道,实现在键过期时异步触发额外动作(如日志记录、数据库清理或回调通知)。
要实现在 Redis 键过期时自动执行额外操作(例如调用 do_extra_on_expire(identifier)),核心思路是:利用 Redis 的键空间通知(Keyspace Notifications)机制,监听 expired 事件,并通过 Pub/Sub 实时响应。该方案无需轮询或修改业务缓存逻辑,完全解耦且高效。
✅ 步骤一:启用 Redis 键空间事件通知
默认情况下 Redis 是禁用事件通知的。需在 Redis 配置中开启对应事件类型。编辑 redis.conf(或通过 CONFIG SET 动态设置):
# 启用键过期事件(E)和键空间通知(K),组合为 "KE" notify-keyspace-events "KE"
? 说明:
K表示 keyspace 事件(如__keyspace@0__:ani),E表示 keyevent 事件(如__keyevent@0__:expired)。推荐订阅__keyevent@0__:expired(更语义清晰、无需解析事件类型)。
验证是否生效:
redis-cli CONFIG GET notify-keyspace-events # 应返回: 1) "notify-keyspace-events" 2) "KE"
✅ 步骤二:编写事件监听服务(Python 示例)
以下是一个独立运行的监听器,订阅过期事件并触发自定义逻辑:
import redis
import threading
class RedisExpirationListener:
def __init__(self, host="localhost", port=6379, db=0):
self.redis_client = redis.Redis(host=host, port=port, db=db)
self.pubsub = self.redis_client.pubsub()
# 订阅数据库 0 的 expired 事件通道
self.pubsub.subscribe("__keyevent@0__:expired")
def on_expired(self, message):
"""处理过期事件:message['data'] 即过期键名"""
key = message["data"].decode("utf-8")
print(f"[INFO] Key expired: {key}")
# ✅ 在此处调用你的额外逻辑
self.do_extra_on_expire(key)
def do_extra_on_expire(self, identifier):
"""替换为你实际的业务逻辑,例如:"""
print(f"[ACTION] Cleaning up dependent resources for '{identifier}'...")
# 示例:调用外部 API、更新数据库状态、发送告警等
# requests.post("https://api.example.com/expire-hook", json={"key": identifier})
def run(self):
print("[LISTENER] Started listening for expired events...")
for message in self.pubsub.listen():
if message["type"] == "message":
self.on_expired(message)
# 启动监听(建议在后台线程或独立进程运行)
if __name__ == "__main__":
listener = RedisExpirationListener()
# 使用守护线程避免阻塞主程序(生产环境建议用 systemd / supervisor 管理)
thread = threading.Thread(target=listener.run, daemon=True)
thread.start()
# 保持主线程活跃(仅演示用)
try:
thread.join()
except KeyboardInterrupt:
print("\n[STOP] Listener stopped.")✅ 步骤三:确保缓存写入兼容事件触发
你原有的 cache_data 方法无需修改,只需保证设置了 EXPIRE(或 SETEX/HSETEX 等带过期参数的命令)即可触发事件:
@classmethod
def cache_data(cls, data1, data2):
identifier = "ani"
pipe = cls.db.pipeline()
pipe.hset(identifier, "first", data1)
pipe.hset(identifier, "second", data2)
pipe.expire(identifier, 3600) # ✅ 此操作将触发 expired 事件
pipe.execute()⚠️ 注意事项:
- 事件非精确实时:Redis 过期事件由惰性删除 + 定期抽样删除触发,存在毫秒级延迟(通常
- 事件仅触发一次:每个过期键最多产生一个
expired事件(即使多次访问已过期键)。- 多实例部署:若使用 Redis Cluster,事件仅在所在分片节点触发;单机或主从架构下,需在主节点监听(从节点不产生事件)。
- 性能影响极小:启用
KE事件对吞吐量影响可忽略,但避免开启冗余事件(如KA或g类事件)。
✅ 总结
通过 notify-keyspace-events "KE" + __keyevent@0__:expired Pub/Sub 订阅,你可在 Redis 键自然过期时零侵入地执行任意 Python 逻辑。这是官方推荐、生产就绪的标准方案——无需定时任务、不增加缓存层负担,真正实现“到期即响应”。建议将监听服务作为独立守护进程部署,并添加重连、日志和错误隔离机制以提升健壮性。


















