Orchestrator 默认不启用自动故障转移,需显式配置 "EnableAutomaticFailover": true 并确保 MySQL 权限、binlog、pseudo-GTID 等条件满足,否则仅能检测主库故障而无法执行切换。

Orchestrator 为什么不能直接“自动切换主从”
Orchestrator 本身不提供开箱即用的全自动故障转移(auto-failover),它只做拓扑发现、分析和可控的主从重配置。是否触发切换、何时切换、切到哪个备库,全靠你定义规则和触发条件。默认配置下,raft-enabled 为 false、detect-master-failure 为 true,但 automatic-failover 是关闭的——这意味着它能发现主库宕机,但不会动手切。
常见错误现象:Failed to detect master failure 或日志里反复出现 Skipping automatic failover: disabled,本质都是没打开关键开关或权限不足。
- 必须显式设置
enable-automatic-failover为 true(注意不是automatic-failover) - Orchestrator 实例需对 MySQL 具备
SUPER或REPLICATION SLAVE ADMIN+CONNECTION ADMIN权限(MySQL 8.0.22+) - 所有参与集群的 MySQL 实例必须开启
log_bin和relay_log_recovery=ON,否则切换后可能复制中断
如何配置 Orchestrator 启用自动故障转移
核心是修改 orchestrator.conf.json 并重载服务。重点不是加一堆参数,而是确保三处协同生效:
-
"EnableAutomaticFailover": true—— 全局开关,必设 -
"FailureDetectionPeriodBlockMinutes": 1—— 防止抖动,建议设为 1~3 分钟,太短易误切 -
"PostFailoverProcesses": ["echo 'failover completed on {{.ClusterName}} to {{.NewMasterHostname}}' >> /var/log/orchestrator/failover.log"]—— 可选但强烈建议加,用于验证是否真触发了流程
别漏掉权限校验:在 MySQL 中执行 SHOW GRANTS FOR 'orc_user'@'%',确认返回包含 REPLICATION SLAVE ADMIN(MySQL 8)或 SUPER(5.7)。否则 Cannot change master 错误会静默吞掉切换动作。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
主库宕机后 Orchestrator 实际怎么选新主
它不按“谁延迟最小”或“谁最热”选,而是严格按内置优先级链:Pseudo-GTID → Binlog coordinates → Server UUID → Server ID。也就是说,即使某台备库延迟 2 秒,只要它有 pseudo-gtid 且位置最新,就会被选中;没开 pseudo-gtid 就退回到比对 Exec_Master_Log_Pos,这时延迟大的反而可能胜出。
- 务必在所有 MySQL 实例启用
pseudo-gtid:在 my.cnf 加gtid_mode=ON+enforce_gtid_consistency=ON(MySQL 5.7+),或手动注入 pseudo-gtid 日志(Orchestrator 文档有脚本) - 避免使用
read_only=ON的备库当候选主库——Orchestrator 默认跳过read_only=ON的实例,除非你设"PreventCrossRegionFailover": false且显式配置"CandidateInstances": ["host1", "host2"] - 切换前会调用
stop slave和reset slave all,所以确保skip_slave_start=OFF,否则新主启动后复制不会自动恢复
切换后应用连不上新主?检查这三处硬编码陷阱
Orchestrator 只改 MySQL 复制关系,不碰 DNS、VIP、应用配置。很多团队以为“切完了就完事”,结果应用还在连旧 IP,或连接池缓存了老主库地址。
- 别依赖
hostname做应用路由:MySQL 的report_host可能是内网名,应用应通过统一入口(如 HAProxy VIP、Consul 服务名)访问,Orchestrator 切换后由负载层重新探活并更新后端 - 检查应用是否启用了
autoReconnect=true和failOverReadOnly=false(JDBC),否则连接断开后不会重试新主 - Orchestrator 的
audit表(orchestrator.audit)会记录每次切换详情,查SELECT * FROM audit WHERE action='failover' ORDER BY id DESC LIMIT 5可快速确认实际切到了哪台机器
真正难的不是让 Orchestrator 切,而是让整个链路——从探测、决策、执行、通知到应用感知——形成闭环。中间任何一环缺监控或硬编码,都会让自动切换变成“自动失联”。

















