Redis主从架构中如何手动强制切换主节点_执行sentinel failover命令-Redis-PHP中文网

sentinel failover返回ok却未切换，常见原因有三：一是quorum值过高导致投票失败，如配置为3但仅2个哨兵在线；二是目标master不在监控列表或已被标记s_down；三是哨兵未完成初始化，sentinel sentinels返回异常。

redis主从架构中如何手动强制切换主节点_执行sentinel failover命令

命令执行后主从状态纹丝不动，不是因为你输错了，而是哨兵在底层检查阶段就卡住了。最常踩的坑有三个：

quorum 值设得太高：比如配置了 sentinel monitor mymaster 127.0.0.1 6379 3，但当前只有 2 个哨兵在线，投票根本起不来
目标 master-name 不在监控列表里：用 SENTINEL MASTER mymaster 查不到，或返回结果中 flags 字段不含 master（可能已被标记为 s_down 或已从拓扑中移除）
哨兵自身未初始化完成：刚启动时 SENTINEL SENTINELS mymaster 返回空或数量异常，说明它还没同步到完整集群视图

直接看日志最省事：tail -f /var/log/redis/sentinel.log，搜 is-master-down-by-addr 或 failover，卡在哪一步一目了然。

SENTINEL FAILOVER 返回 OK 只代表哨兵收下了指令，切换是异步协商过程，必须分三处验证状态是否真正收敛：

查哨兵视角：SENTINEL MASTER mymaster，确认 flags 含 failover_in_progress，且 num-slaves、num-other-sentinels 数值合理（比如旧主掉线后，num-slaves 应该减少）
查新主库：INFO replication 中 role:master 且 master_host: 为空（不是从别的节点同步），同时 connected_slaves > 0
查旧主库：它应已变成 role:slave，且 master_host 指向新主的 IP+端口；若仍是 role:master 或 master_host 为空，说明复制关系重建失败

哨兵默认选优先级最高的从库（由 slave-priority 决定），不保证是你想要的那一台。要强制指定：

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

下载

提前把其他从库的 slave-priority 改为 0（在对应 redis.conf 里配，然后 CONFIG REWRITE 或重启生效）
确保目标从库的 slave-priority 是正整数（如默认的 100），且网络延迟低、复制偏移量最新
执行 SENTINEL FAILOVER mymaster 后，等切换完成再把其他从库的 slave-priority 调回原值，否则下次故障转移还会跳过它们

注意：slave-priority 0 的从库永远不会被选为主，但也不会拒绝同步——只是彻底退出选举队列。

SENTINEL FAILOVER 绕过了真实故障路径的关键环节，导致很多线上问题演练时根本暴露不出来：

不走 down-after-milliseconds 判断逻辑，测不出你设的发现延迟是否合理；也不触发 s_down → o_down 状态跃迁，无法验证 quorum 配置是否生效
不模拟主进程崩溃或网络分区，旧主恢复后能否自动重连新主、是否因 replica-announce-ip 配错或防火墙拦截而失败，这些全被跳过
客户端连接池不会收到 +switch-master 通知，重定向逻辑压根没跑，实际流量切不过去也看不出来

真要测高可用能力，必须搭配断网、kill -9、改防火墙规则等手段，不能只依赖 SENTINEL FAILOVER。