MySQL GTID复制配置:一个参数都不能少
想把MySQL的复制架构升级到GTID模式?这事儿听起来简单,但配置环节里藏着不少“一票否决”的细节。很多朋友照着教程配,结果MySQL启动不了,或者复制链路死活搭不起来,问题往往就出在几个关键参数的联动上。今天,咱们就来把GTID配置的“铁律”彻底捋清楚。
必须同时设置 gtid_mode = ON 和 enforce_gtid_consistency = ON,否则 MySQL 启动失败;还需启用 log_bin 和 binlog_format = ROW,并使用 MASTER_AUTO_POSITION = 1 配置复制,且主从 GTID_EXECUTED 必须一致。

记住这个核心原则:gtid_mode = ON 和 enforce_gtid_consistency = ON 必须成对出现,缺了任何一个,MySQL要么启动失败,要么复制功能直接罢工。
为什么只配 gtid_mode = ON 会报错
你猜怎么着?如果MySQL启动时发现gtid_mode = ON,但enforce_gtid_consistency = OFF,它会毫不犹豫地拒绝启动,并抛出一个明确的错误:ERROR 3124 (HY000): @@GLOBAL.GTID_MODE = ON requires @@GLOBAL.ENFORCE_GTID_CONSISTENCY = ON.
enforce_gtid_consistency = ON扮演着安全闸门的角色:它会禁止执行那些在GTID模式下可能导致数据不一致的语句,比如CREATE TABLE ... SELECT、用户变量赋值(@a := 1这类),或者临时表的混用。- 少了这层限制,主从之间很可能因为非确定性的SQL语句而产生数据分歧,那GTID保证全局一致性的初衷就完全失去了意义。
- 在配置文件里,这两个参数的先后顺序无所谓,但它们必须共存。漏掉任何一个,mysqld进程根本起不来,就是这么绝对。
log_bin 和 binlog_format = ROW 为什么也强制要求
GTID的本质是给每个事务一个全局唯一的“身份证号”,而这个编号的源头,正是二进制日志。没有开启log_bin,事务就失去了编号的依据;如果使用STATEMENT格式的binlog,像NOW()、UUID()、自增主键这类语句,在主从执行时会产生不同的结果——MySQL会直接拦截这类语句并报错:ERROR 1786 (HY000): Statement violates GTID consistency。
log_bin的值简单写成mysql-bin就行,不用加路径;MySQL会自动把它补全到datadir目录下。binlog_format = ROW是硬性前提。在MIXED或STATEMENT模式下设置gtid_mode = ON,同样会被MySQL拒绝。- 即使你只打算做单向复制,从库也必须开启
log_bin。否则,级联复制链路会中断,而且部分GTID状态的校验逻辑也会出现异常。
CHANGE MASTER TO 必须用 MASTER_AUTO_POSITION = 1
开启GTID之后,配置复制连接时就别再想着用MASTER_LOG_FILE和MASTER_LOG_POS这种传统位点了。一旦混用,执行START SLA VE会立刻失败,并提示:ERROR 1776 (HY000): Parameters MASTER_LOG_FILE, MASTER_LOG_POS, RELAY_LOG_FILE and RELAY_LOG_POS cannot be set when MASTER_AUTO_POSITION is enabled.
- 正确姿势是使用
MASTER_AUTO_POSITION = 1(注意是数字1,不是字符串'ON'或布尔值)。 - 执行
CHANGE MASTER TO命令前,务必先STOP SLA VE,否则命令会被默默忽略。 - 如果主从库的
GTID_EXECUTED集合不兼容(比如从库需要某个主库已经清理掉的事务),START SLA VE就会卡住或者报ERROR 3037。遇到这种情况,通常只能选择重建从库,或者通过注入空事务来手动对齐GTID集合。
验证是否真生效:别只看配置文件
配置文件写对了,不等于GTID就真的在线上跑起来了。最可靠的判断依据,是去查MySQL的运行时变量:
- 查
SELECT @@gtid_mode;—— 返回值必须是ON(不能是OFF_PERMISSIVE这类过渡状态)。 - 查
SELECT @@enforce_gtid_consistency;—— 返回值必须是ON。 - 查
SHOW SLA VE STATUS\G输出中的Using_Gtid字段 —— 应该显示为Current_Pos,而不是No。 - 初始数据同步完成后,主从库执行
SELECT @@global.gtid_executed;的结果必须完全一致。否则,后续的事务就可能出现跳跃或冲突,而且这种不一致不会自动修复。
这里有个最容易被忽略的坑:初始数据与GTID执行集的对齐。GTID只管“新增”的事务,不负责“历史”数据。如果备份时没用--master-data=2这类参数记录GTID信息,或者恢复后没有校验gtid_executed,那么后续所有的复制问题,根源可能都在这儿。这才是关键所在。
