Redis哨兵无法触发自动故障转移,主因是quorum值大于当前可通信哨兵数导致卡在客观下线前,如设3但仅2台在线,SENTINEL ckquorum返回ERR missing+quorum,日志仅见+sdown无+odown;quorum须≤实际互通哨兵数,推荐⌊N/2⌋+1且需SENTINEL set运行时生效并验证。

绝大多数情况,不是哨兵“不会切换”,而是它根本没走到故障转移那一步——卡在了客观下线(ODOWN)之前的仲裁环节。
quorum 值大于当前在线哨兵数,直接卡死在 missing+quorum
这是生产环境里最常见、也最容易被忽略的硬性失败点。哨兵启动时读取 sentinel monitor mymaster 192.168.1.100 6379 3 中的 3,代表需要至少 3 台哨兵达成一致才能判定主节点客观下线。但如果实际只有 2 台哨兵能互相通信(防火墙拦截、网络分区、配置未同步),这个 3 就永远无法满足。
-
SENTINEL ckquorum mymaster返回ERR missing+quorum是铁证 - 日志里反复出现
+sdown master mymaster,但始终没有+odown—— 说明连“多数派确认”这关都没过 - 执行
redis-cli -p 26379 SENTINEL sentinels mymaster看返回几条记录,不是看进程数,而是看真实能交换 hello 消息的哨兵数量 - 推荐值是
⌊N/2⌋ + 1:3 台哨兵设2,5 台设3;设成1容易误切,设成N则单点失联即瘫痪
quorum 配置改了但根本没生效
哨兵不热重载 quorum,改完 sentinel.conf 不等于改完了。配置写错、没重启、或只改了一台,都会让整个集群失效。
- 启动失败场景:
sentinel monitor行末尾的quorum写成"2"、2.0或带空格,redis-sentinel直接退出,报Invalid argument 'quorum' - 运行中修改必须用命令:
redis-cli -p 26379 SENTINEL set mymaster quorum 2,逐台执行,不能只改一台 - 验证是否生效:
redis-cli -p 26379 SENTINEL master mymaster,看输出里的quorum字段——它显示的是当前协商值,不是配置文件原始值 - 别跳过
--test-conf:改完配置先跑redis-sentinel /path/to/sentinel.conf --test-conf,语法错当场暴露
哨兵之间无法同步监控配置,各管各的主库
哨兵靠 hello 消息广播 sentinel monitor 规则。如果某台哨兵没收到完整广播,它眼里就没有这个主节点,自然不会参与投票。
- 现象:
SENTINEL masters在不同哨兵上输出不一致——有的返回空,有的返回fail,有的压根没mymaster这个名字 - 原因包括:新哨兵刚启动还没等够 30 秒(默认
default-down-after-milliseconds的两倍)就遭遇故障;某台哨兵长期离线后重新加入,但没完成配置同步 - 检查手段:
redis-cli -p 26379 INFO sentinel查看sentinels和known-sentinels数量是否匹配;对比各哨兵的sentinel known-replicas mymaster输出是否一致
真正麻烦的从来不是“怎么配”,而是“为什么配了却没用”。quorum 仲裁、配置同步、网络连通性这三环,只要断一环,故障转移就停在第一步。线上排查时,先盯 missing+quorum 和 SENTINEL sentinels,比翻日志快得多。


















