一聚教程网:一个值得你收藏的教程网站

热门教程

如何在不停止业务时在线开启MySQL GTID模式?

时间:2026-07-03 11:09:51 编辑:袖梨 来源:一聚教程网

MySQL 5.7+在线开启GTID必须分三步:先设OFF_PERMISSIVE,再ON_PERMISSIVE,最后ON,严禁跳步;每步需主从同步执行并确认生效,且ON前须确保enforce_gtid_consistency=ON、无匿名事务残留、binlog_format=ROW、log_slave_updates=ON。

在线开启 GTID 必须分三步走,不能跳过 OFF_PERMISSIVE 和 ON_PERMISSIVE

MySQL 5.7+ 不允许直接 SET GLOBAL gtid_mode = ON,否则报错 ERROR 1788 (HY000): The value of @@GLOBAL.GTID_MODE can only be changed one step at a time。必须严格按顺序切换:先 OFF_PERMISSIVE → 再 ON_PERMISSIVE → 最后 ON。每一步执行后都要确认生效,且主从所有节点必须同步完成当前步再进下一步。

常见错误是只在主库设了 ON_PERMISSIVE 就急着设 ON,结果从库卡住、复制中断。正确做法是:主从都执行完 SET GLOBAL gtid_mode = OFF_PERMISSIVE 后,再统一执行 ON_PERMISSIVE;等确认无活跃匿名事务(见下一条),再一起设为 ON

执行 ON 前必须确认 enforce_gtid_consistency=ON 且无匿名事务残留

SET GLOBAL gtid_mode = ON 会直接失败,如果 enforce_gtid_consistency 还是 OFFWARN —— 报错 ERROR 3111 (HY000): SET @@GLOBAL.GTID_MODE = ON is not allowed because ENFORCE_GTID_CONSISTENCY is not ON。所以必须提前执行:

  • SET GLOBAL enforce_gtid_consistency = ON(注意不是 WARN)
  • SET GLOBAL binlog_format = ROW(若当前不是 ROW,会报 ER_GTID_MODE_ON_WITH_STATEMENT_BINLOG_FORMAT
  • 检查是否有未提交的长事务:SELECT * FROM INFORMATION_SCHEMA.INNODB_TRX WHERE TIMESTAMPDIFF(SECOND, trx_started, NOW()) > 60,有则需协调业务终止
  • 确认无进行中匿名事务:SHOW STATUS LIKE 'ONGOING_ANONYMOUS_TRANSACTION_COUNT' 返回值必须为 0

phpEnv 环境下无法纯命令行开启,必须改 my.ini + 重启

phpEnv 的图形界面不提供 GTID 控制入口,SET GLOBAL gtid_mode 在其管理的 MySQL 实例中默认被禁用(报 ERROR 1238 (HY000): Variable 'gtid_mode' is a read only variable)。你看到的“MySQL 配置”按钮只是打开 my.ini,最终必须手动编辑并重启服务。

关键点在于:即使你已在线执行过 OFF_PERMISSIVE 等步骤,只要没写入配置文件,MySQL 重启后就会回退到 OFF。所以必须在 phpenvversionsmysql-5.7.31my.ini(路径以实际为准)的 [mysqld] 段末尾补全:

gtid_mode = ONenforce_gtid_consistency = ONlog_bin = mysql-binbinlog_format = ROWlog_slave_updates = ON

漏掉 log_slave_updates = ON 是从库复制中断最常见原因;log_bin 路径若不可写,MySQL 启动会静默失败。

主从初始化必须用 --set-gtid-purged=ON,别碰 --master-data

GTID 模式下,mysqldump --master-data=2 生成的 CHANGE MASTER TO MASTER_LOG_FILE 完全无效,强行执行会导致从库报错 Could not execute Write_rows eventSeconds_Behind_Master: NULL

唯一安全方式是:

  • 主库导出:mysqldump --all-databases --single-transaction --set-gtid-purged=ON > full.sql--single-transaction 必加,否则 gtid_executed 快照不准)
  • 从库导入前先清空旧复制状态:RESET SLAVE ALL(不是 RESET SLAVE
  • 导入后执行:CHANGE MASTER TO MASTER_HOST='xxx', MASTER_AUTO_POSITION = 1

最容易忽略的是:phpEnv 多实例共用模板时,server_id 默认都是 1,主从必须人工改为不同值,否则 START SLAVE 直接拒绝。

热门栏目