
Redis 本身不支持直接在键过期时同步执行回调函数,但可通过启用键空间通知(Keyspace Notifications)配合 Pub/Sub 机制,在键被删除时实时捕获 expired 事件并执行额外逻辑。
redis 本身不支持直接在键过期时同步执行回调函数,但可通过启用键空间通知(keyspace notifications)配合 pub/sub 机制,在键被删除时实时捕获 `expired` 事件并执行额外逻辑。
Redis 并未提供类似“过期钩子(expire hook)”的原生回调接口——当一个键因 TTL 到期被自动删除时,服务端不会主动调用用户代码。但 Redis 提供了强大的 键空间通知(Keyspace Notifications) 功能,允许你订阅特定类型的服务器事件(如 expired、del 等),从而在键过期瞬间收到通知,并在外部程序中执行任意逻辑(例如清理本地缓存、记录审计日志、触发异步任务等)。
✅ 启用键空间通知(必需步骤)
默认情况下该功能是关闭的。需在 Redis 配置中启用,或通过命令动态开启:
# 方式1:修改 redis.conf(推荐用于生产) notify-keyspace-events "Ex" # 方式2:运行时启用(仅当前实例有效) CONFIG SET notify-keyspace-events "Ex"
参数说明:
-
E表示启用 keyspace event(键空间事件); -
x表示监听expired事件(小写 x);
✅ 组合"Ex"即表示仅接收键过期事件(最小化干扰,提升性能与安全性)。
⚠️ 注意:
"AKE"等宽泛配置会广播大量事件(包括所有键的 DEL、SET、EXPIRE 等),易引发消息风暴,不推荐在生产环境使用。
✅ 订阅过期事件(Python 示例)
使用 redis-py 监听 __keyevent@0__:expired 频道(其中 0 是数据库编号,按实际 db 调整):
import redis
import threading
class RedisExpiryListener:
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()
# 订阅 db0 的 expired 事件频道
self.pubsub.subscribe(f"__keyevent@{db}__:expired")
def do_extra_on_expire(self, key: str):
"""在此定义你的业务逻辑,例如:"""
print(f"[INFO] Key expired: {key}")
# ✅ 示例:触发异步数据重建、发送告警、更新统计等
# requests.post("https://api.example.com/refresh", json={"key": key})
def handle_message(self, message):
if message["type"] == "message":
expired_key = message["data"].decode("utf-8")
self.do_extra_on_expire(expired_key)
def run(self):
print("[LISTENER] Started listening for expired events...")
for message in self.pubsub.listen():
self.handle_message(message)
# 启动监听(建议在独立线程或后台进程运行)
if __name__ == "__main__":
listener = RedisExpiryListener(db=0)
thread = threading.Thread(target=listener.run, daemon=True)
thread.start()
# 你的主业务逻辑(例如缓存写入)
cache_client = redis.Redis(host="localhost", port=6379, db=0)
cache_client.hset("ani", mapping={"first": "a", "second": "b"})
cache_client.expire("ani", 5) # 5秒后触发
print("Cached 'ani' with 5s TTL. Wait for expiry...")
thread.join(timeout=10)
⚠️ 关键注意事项
-
事件非 100% 可靠:
expired事件由 Redis 主动发布,但若监听客户端断连、Pub/Sub 队列溢出或 Redis 重启,可能丢失事件。对强一致性要求场景,应结合「惰性删除 + 定期扫描」兜底。 - 事件时机:事件在键被惰性/定期删除后立即发布,不是精确到毫秒的定时器;高负载下可能有轻微延迟(通常
-
避免阻塞监听器:
do_extra_on_expire()中禁止执行耗时同步操作(如 HTTP 请求、DB 写入),建议转为异步任务(Celery、asyncio 或消息队列)。 - 多实例部署:若使用 Redis Cluster,需为每个分片节点单独配置并监听;Sentinel 或主从架构下,仅需监听主节点(从节点不发布事件)。
✅ 总结
要实现在 Redis 键过期时执行额外动作,核心路径是:
① 启用 notify-keyspace-events "Ex";
② 使用 Pub/Sub 订阅 __keyevent@{db}__:expired;
③ 在监听端解析 message["data"] 获取过期键名,执行自定义逻辑。
该方案轻量、解耦、符合 Redis 设计哲学,是目前官方推荐且生产验证的最佳实践。











