gtid模式下主从切换后拓扑重构必须执行reset slave all并使用master_auto_position=1，因仅改master_host会沿用旧binlog位点导致同步失败；须校验新主gtid_executed覆盖所有从库、gtid_purged不缺失，且禁止带master_log_file/pos。
GTID模式下主从切换后的拓扑重构，核心就一条：所有从库执行 CHANGE MASTER TO ... MASTER_AUTO_POSITION=1，但必须先清空旧状态、校验 GTID 集合对齐，否则复制会卡在 Waiting for source to send event 或直接报错。
为什么拓扑重构不能只改 MASTER_HOST？
从库内部仍保留着旧主的 master_log_file 和 master_log_pos，哪怕你只改 MASTER_HOST，MySQL 仍会尝试按位置同步——而新主根本没有那个 binlog 文件或偏移量。结果就是：Client requested master to start replication from position > file size 或无限等待。
必须显式清除旧位点信息：
STOP SLAVE;-
RESET SLAVE ALL;（注意是ALL，RESET SLAVE不清gtid_purged） - 再执行
CHANGE MASTER TO，且**绝对不带MASTER_LOG_FILE或MASTER_LOG_POS**
切换前必须验证新主的三个 GTID 状态值
候选新主库不是“能连上就行”，它必须能覆盖所有从库已执行的事务，否则从库会跳过数据或重复执行。重点检查：
-
SELECT @@global.gtid_executed;—— 必须包含所有从库的Executed_Gtid_Set（可用SELECT * FROM performance_schema.replication_connection_status查各从库上报的集合） -
SELECT @@global.gtid_purged;—— 不能比任何从库的Executed_Gtid_Set少，否则报Cannot replicate because the master purged required binary logs -
SHOW SLAVE STATUS\G中的Retrieved_Gtid_Set和Executed_Gtid_Set差集必须为空（即已追平）
若发现 gtid_purged 缺失，不要用 SET GLOBAL gtid_purged = ... 补充（除非 gtid_executed 为空），应优先重搭或从含完整 --set-gtid-purged=ON 的备份恢复。
混合拓扑（旧主为 FILE/POSITION，新主为 GTID）怎么切？
这种场景最容易出错，因为从库可能还残留匿名事务（anonymous GTID）。操作前务必确认：
- 新主已启用
gtid_mode=ON且enforce_gtid_consistency=ON - 从库执行
STOP SLAVE; RESET SLAVE ALL;后，再运行CHANGE MASTER TO MASTER_AUTO_POSITION=1 - 如果从库报错
ERROR 1777 (HY000): Setting MASTER_AUTO_POSITION=1 requires a non-empty @@GLOBAL.GTID_EXECUTED，说明它还没执行过任何 GTID 事务——需先用mysqldump --set-gtid-purged=ON导入一次初始数据，或等它从旧主拉完 binlog 并转换完成
双主或环形拓扑中，新主切完后其他从库如何安全接入？
新主提升后，自身 gtid_executed 会新增一段属于它的事务序列（server_uuid:new_tid）。其他从库连过去时，必须确保不会把新主刚产生的事务又 relay 回去，引发循环复制：
- 禁用
log_slave_updates是常见错误——这会让新主无法被下游接入，高可用链断裂 - 稳妥做法是配置
replicate_ignore_server_ids（MySQL 8.0.23+），明确排除新主自己的server_uuid - 验证是否生效：在新主执行一条 INSERT 后，查其他从库的
SELECT @@global.gtid_executed;，结果里不应出现新主的server_uuid对应的事务段
真正容易被忽略的点是：拓扑重构不是“改个 IP 就完事”，而是整个 GTID 集合的对齐与边界控制。一旦某个从库的 gtid_executed 落后于新主的 gtid_purged，它就永远追不上——这个缺口不会自动修复，只能人工介入补日志或重搭。
