必须同时开启enforce_gtid_consistency=ON,否则复制失败;gtid_mode需分步设为OFF_PERMISSIVE→ON_PERMISSIVE→ON;从库server-id和auto.cnf必须唯一;连接时必须用SOURCE_AUTO_POSITION=1。

MySQL 8.0启用GTID后,**必须同时开启 enforce_gtid_consistency=ON,否则复制会失败或产生不一致**。这是最常被忽略的硬性前提,不是可选项。
为什么enforce_gtid_consistency不能关
GTID要求每个事务都具备全局唯一标识,而某些语句(如 CREATE TEMPORARY TABLE、INSERT ... SELECT 在非事务引擎上、带 UUID() 或用户变量的语句)无法安全生成 GTID。关闭该参数会让 MySQL 允许这些语句执行,但主库写入后,从库可能因 GTID 冲突、跳过或报错导致数据分裂。
常见错误现象:
- 从库 SQL 线程报错:
ERROR 1782 (HY000): Statement violates GTID consistency - 主库能执行成功,从库
SHOW SLAVE STATUS\G中Seconds_Behind_Master持续增长且SQL_Remaining_Delay非零 -
gtid_executed和gtid_purged在主从间不匹配,RESET MASTER后无法用CHANGE REPLICATION SOURCE TO正确对接
gtid_mode 必须分步启用,不能直接设为 ON
MySQL 8.0 要求 gtid_mode 的变更必须按顺序执行,否则服务启动失败或复制中断。尤其当实例已有 binlog 且存在匿名事务时,跳步会导致 mysqld 拒绝启动。
正确步骤(在主库和从库上分别执行):
SET GLOBAL gtid_mode = OFF_PERMISSIVE;SET GLOBAL gtid_mode = ON_PERMISSIVE;- 确认
SHOW STATUS LIKE 'Anonymous_gtid_transactions';返回空结果(即无匿名事务残留) SET GLOBAL gtid_mode = ON;- 最后在配置文件中固化:
gtid_mode=ON和enforce_gtid_consistency=ON,再重启生效
注意:OFF_PERMISSIVE → ON_PERMISSIVE 这两步不可逆,一旦执行就不能回退到纯非 GTID 模式,生产环境操作前务必备份。
从库 server-id 和 auto.cnf 必须唯一
复制链中每个节点的 server-id 是 GTID 定位事务来源的基础。若从库是克隆主库虚拟机而来,/var/lib/mysql/auto.cnf 文件中的 server-uuid 会完全相同,导致从库拒绝接收主库 binlog(报错:Received duplicate UUID from server)。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
实操建议:
- 从库首次启动前,先删除
/var/lib/mysql/auto.cnf(MySQL 会自动生成新 UUID) -
server-id值必须为非零整数,且全集群唯一;推荐用 IP 最后一段(如10.0.0.102→server-id = 102) - 不要复用旧从库的 datadir 目录,否则残留的
gtid_executed可能与当前主库不兼容
连接从库时必须用 CHANGE REPLICATION SOURCE TO + SOURCE_AUTO_POSITION = 1
GTID 模式下,不能再用传统基于 SOURCE_LOG_FILE 和 SOURCE_LOG_POS 的方式指定起点——这会绕过 GTID 自动定位机制,极易出错。
正确命令格式(从库执行):
CHANGE REPLICATION SOURCE TO SOURCE_HOST='10.0.0.101', SOURCE_PORT=3306, SOURCE_USER='repl_user', SOURCE_PASSWORD='xxx', SOURCE_AUTO_POSITION = 1;
关键点:
-
SOURCE_AUTO_POSITION = 1是 GTID 复制的开关,缺一不可 - MySQL 8.0.23+ 强制使用
CHANGE REPLICATION SOURCE TO,旧版CHANGE MASTER TO已废弃 - 执行前确保从库已停掉复制:
STOP REPLICA;(注意不是STOP SLAVE)
如果主库 binlog 已被清理,而从库缺失部分 GTID,START REPLICA 会卡在 Retrieving GTID set for channel '' from master,此时需人工校准 gtid_purged,但这是高风险操作,应尽量避免。
GTID 主从最脆弱的环节不在配置本身,而在「主库已启 GTID、从库未清 auto.cnf」或「忘记设 enforce_gtid_consistency」这种低级但致命的疏漏。只要这两项守住,后续同步基本不会因 GTID 机制自身出问题。










