如何在Python中通过redis-py连接Redis哨兵集群-Redis-PHP中文网

strictredis.from_url()无法连接哨兵集群，因只支持直连；必须用sentinel客户端显式连接哨兵节点列表，配置socket_timeout、密码等参数，并通过master_for/slave_for获取主从连接，且需确保service_name与sentinel monitor一致。

如何在python中通过redis-py连接redis哨兵集群

用 `StrictRedis.from_url()` 连哨兵集群行不通

很多人试过直接把哨兵地址塞进 redis:// URL 里，比如 redis://127.0.0.1:26379，结果报错 ConnectionError: Error 111 connecting to 127.0.0.1:26379. Connection refused.。这是因为 from_url() 只支持直连 Redis 实例，不识别哨兵协议，也不会自动发现主节点。

必须显式使用哨兵客户端，让 redis-py 主动和哨兵通信、获取当前主库地址再连接。

正确初始化 `Sentinel` 客户端的三个关键点

哨兵连接不是“连一个地址”，而是“连一组哨兵节点”，由它们投票选出主库并返回可连地址。初始化时容易漏掉或配错以下几点：

sentinels 参数必须是 [(host, port), ...] 元组列表，不是单个字符串或字典
socket_timeout 建议设为 0.5 左右，避免哨兵响应慢导致阻塞（默认是 None，会卡死）
如果哨兵启用了认证，需额外传 password 和 sentinel_kwargs（比如 sentinel_kwargs={'password': 'mypass'}），否则连哨兵本身就会失败

示例：

from redis.sentinel import Sentinel
<p>sentinel = Sentinel(
sentinels=[('10.0.0.1', 26379), ('10.0.0.2', 26379), ('10.0.0.3', 26379)],
socket_timeout=0.5,
password='sentinel_pass',  # 哨兵自身的密码（非 Redis 密码）
sentinel_kwargs={'password': 'sentinel_pass'}
)</p>

获取主从连接后，`master` 和 `slave` 对象不能混用

调用 sentinel.master_for('mymaster') 返回的是一个主连接对象，所有写操作（set、hset 等）必须走它；sentinel.slave_for('mymaster') 返回只读连接，发写命令会直接抛 ReadOnlyError。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

常见错误包括：

误把 slave_for 当成主连接用，执行 set 报错 READONLY You can't write against a read only slave.
在多线程/协程中复用同一个 master 实例，没做连接池管理，导致超时或连接泄漏
没检查哨兵中配置的 service_name（即 'mymaster'）是否和 redis-sentinel.conf 里 sentinel monitor 的名字完全一致（大小写敏感）

推荐写法：

master = sentinel.master_for('mymaster', db=0, password='redis_pass')
slave = sentinel.slave_for('mymaster', db=0, password='redis_pass')
<p>master.set('key', 'value')   # ✅
slave.get('key')             # ✅
slave.set('key', 'x')        # ❌ ReadOnlyError</p>

连接失败时，先确认哨兵是否真能发现主节点

代码报 NoValidSentinelError 或反复重试后仍连不上，大概率不是 Python 配置问题，而是哨兵集群自身状态异常：

用 redis-cli -p 26379 连任意一个哨兵，执行 SENTINEL masters，看输出里 ip 和 port 是否指向当前存活的 Redis 主实例
如果 num-slaves 是 0 或 flags 含 odown，说明哨兵没达成共识，需检查 Redis 实例是否存活、网络是否通、sentinel monitor 配置的 quorum 是否合理
Python 客户端不会自动重载哨兵列表，如果哨兵节点增减了，得重启应用或手动重建 Sentinel 实例