Redis哨兵模式如何配置才能实现自动故障转移？-Redis-PHP中文网

必须至少部署3个哨兵节点且quorum设为2，否则故障转移不触发；sentinel monitor是监控入口，名称、ip、端口、quorum缺一不可，名称需与客户端连接时严格一致，quorum=2确保过半共识避免脑裂，哨兵须同时连通主节点、从节点及其他哨兵才能完成客观下线与故障转移。

redis哨兵模式如何配置才能实现自动故障转移？

必须至少部署3个哨兵节点，且 quorum 值设为2（即过半数），否则故障转移不会触发——这是生产环境踩坑最多的一条。

sentinel monitor 配置必须带对名称、IP、端口和 quorum

这一行是哨兵启动监控的唯一入口，写错一个参数就无法发现主节点：

sentinel monitor mymaster 192.168.2.20 6379 2 中的 mymaster 是自定义别名，所有后续配置和客户端连接都依赖它，不能含下划线以外的特殊字符
IP 必须是主节点真实可连地址，不是 127.0.0.1 或 localhost（容器或跨主机时尤其容易错）
quorum 2 表示至少2个哨兵达成一致才进入客观下线（ODOWN），若只部署2个哨兵，quorum 设为2会导致脑裂时无法决策；设为1又失去容错意义

down-after-milliseconds 和 failover-timeout 要匹配业务容忍度

这两个超时值直接决定故障转移是否“及时”还是“误判”：

sentinel down-after-milliseconds mymaster 30000：单个哨兵连续30秒未收到PING响应，标记为主观下线（SDOWN）。太短（如5000）易受网络抖动影响；太长（如120000）导致故障发现滞后
sentinel failover-timeout mymaster 180000：整个故障转移流程最长耗时（含选举、同步、重配置），必须大于 parallel-syncs × slave-serve-stale-data 的实际开销，否则可能中断在中途
若从节点启用了 requirepass，还需加 sentinel auth-pass mymaster your_password，否则哨兵无法连接从库执行 slaveof no one

客户端连接哨兵时，name 参数必须与 monitor 名称严格一致

比如 Python 的 redis-py 客户端：

from redis.sentinel import Sentinel
sentinel = Sentinel(
    sentinels=[('192.168.2.21', 26379), ('192.168.2.22', 26379)],
    socket_timeout=0.5
)
master = sentinel.master_for('mymaster')  # ← 这里必须填 'mymaster'，不是 IP 或其他别名

Node.js 的 node-redis 同理：

Redis Skill - 高性能缓存管理

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

下载

const sentinel = await createSentinel({
  name: 'mymaster', // ← 必须和 sentinel.conf 里的 monitor 名称完全相同
  sentinelRootNodes: [{ host: '192.168.2.20', port: 26379 }]
})

名称不一致会导致 ConnectionError: No master found for 'xxx'，且哨兵日志里不会报错，只会静默忽略该请求。

哨兵之间无法自动发现？检查 sentinel:hello 频道和 INFO replication

哨兵集群靠两个机制互相认识：订阅主节点的 __sentinel__:hello 频道 + 拉取 INFO replication 获取从库列表。常见断连原因：

主节点禁用了 Pub/Sub（notify-keyspace-events 未包含 E）→ 哨兵收不到 hello 消息
主节点设置了密码但没配 sentinel auth-pass → 哨兵连不上主节点，自然拿不到 INFO 和频道权限
防火墙或安全组没放开哨兵端口（默认26379）之间的 TCP 连通性 → 哨兵间 gossip 失败，SENTINEL SENTINELS mymaster 查不到其他哨兵

验证方式：连上任一哨兵，执行 SENTINEL SENTINELS mymaster，返回空数组就说明发现失败；再执行 INFO replication 看是否能拿到从库列表。

真正容易被忽略的是：哨兵进程本身不存数据，但它必须能稳定连接主节点、所有从节点、以及其它哨兵——三类连接缺一不可。任何一类连不上，都会卡在 SDOWN 到 ODOWN 的中间状态，故障转移永远不开始。