首页/数据/Redis 进阶速查/FAILOVER 命令:受控切换
主从与哨兵51 条

FAILOVER 命令:受控切换

6.2 起提供 FAILOVER 命令做协调式切换:主库等待从库追平后提升目标从库并把其他从库指向新主,减少手工步骤与分叉风险。

Redis 进阶速查数据更新于 2026-10-12
用法FAILOVER [TO host port] [FORCE] [ABORT]
前置在待切换的主库上执行
查看INFO replication 的 failover_state

示例

示例
redis-cli FAILOVER TO 10.0.0.12 6379
redis-cli INFO replication | Select-String failover_state
不带 TO 时由主库自行选择从库;FORCE 跳过与目标从库的同步校验,仅在目标不可达等场景使用。

易错点

  • FAILOVER 只处理 Redis 侧切换,客户端地址更新仍需配套机制
  • FORCE 会牺牲一致性校验,非必要不用

数据来源与参考

  • Redis 官方文档:FAILOVER 命令
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌