Redis Sentinel故障转移场景下 使用redis-py如何刷新master客户端对象
Redis Sentinel订阅主节点切换事件的正确方案
核心问题原因
+switch-master是Sentinel节点自身发布的事件,不属于Redis主/从数据节点的事件通道,你向旧主节点订阅该事件自然无法收到通知,旧主节点下线后连接还会直接断开。- redis-py封装的
Sentinel对象本身不直接提供pubsub方法,你需要先获取Sentinel节点对应的Redis客户端实例,再调用pubsub能力。
正确实现方式
Sentinel实例的sentinels属性保存了所有已连接的Sentinel节点的原生Redis客户端对象,任选一个可用的即可订阅事件。redis-py的master_for、slave_for返回的客户端内置了地址自动发现逻辑,你只需要在收到切换事件后断开旧连接池的连接,下次执行命令时会自动向Sentinel查询新的节点地址重建连接,无需手动修改节点配置。
完整实现示例:
from redis.sentinel import Sentinel import threading # 初始化时建议传入所有Sentinel节点地址,避免单节点故障 sentinel = Sentinel([("localhost", 5000), ("localhost", 5001), ("localhost", 5002)], socket_timeout=0.1) master = sentinel.master_for("mymaster", socket_timeout=0.1, retry_on_timeout=True) slave = sentinel.slave_for("mymaster", socket_timeout=0.1, retry_on_timeout=True) # 后台线程监听主节点切换事件 def listen_switch_event(): # 获取一个可用的Sentinel节点客户端 sentinel_client = sentinel.sentinels[0] ps = sentinel_client.pubsub() ps.subscribe("+switch-master") for message in ps.listen(): if message["type"] == "message": # 消息格式:b'mymaster 旧主IP 旧主端口 新主IP 新主端口' print(f"主节点切换完成: {message['data'].decode()}") # 断开旧连接池的所有连接,下次请求自动拉取新地址重建连接 master.connection_pool.disconnect() slave.connection_pool.disconnect() # 启动后台监听线程,随主进程退出 threading.Thread(target=listen_switch_event, daemon=True).start()
关于client-reconfig-script的说明
该配置是Sentinel故障转移完成后触发执行的外部脚本,一般用于修改负载均衡规则、DNS解析记录等全局公共配置,无法直接修改应用进程内部的内存对象,你的场景完全不需要使用该方案。
优化建议
- 如果没有自定义切换事件处理需求,只要给
master_for、slave_for配置合理的超时和重试参数,redis-py内置的逻辑已经会在连接失败时自动刷新节点地址,无需额外订阅事件。 - 事件监听逻辑需要放在独立的后台线程执行,不要阻塞业务线程。
内容的提问来源于stack exchange,提问作者Kaushal28
相关产品推荐
相关产品推荐

