主从GTID模式不匹配是IO线程停止的常见原因,需检查主从gtid_mode、enforce_gtid_consistency及binlog_format是否一致,并确保配置生效且复制线程已完全停止后再修改。

看报错信息里有没有 GTID_MODE 或 ERROR 1236
只要从库 SHOW REPLICA STATUS\G 显示 Replica_IO_Running: No,且 Last_IO_Error 包含 GTID_MODE = ON 和 this server has GTID_MODE = OFF 这类对比句式,基本就是主从 GTID 模式不匹配。另一种典型是 ERROR 1236 (HY000): Got fatal error 1236 from master when reading data from binary log —— 这不是网络或权限问题,而是主库发来的 binlog 事件带 GTID,但从库当前配置拒绝解析。
注意:MySQL 8.0 默认强制开启 GTID,但升级上来的旧实例可能仍保留 gtid_mode = OFF;而新搭的从库如果没同步主库的 enforce_gtid_consistency = ON,也会卡在 IO 线程启动阶段。
查主从两端的 gtid_mode 和 enforce_gtid_consistency 是否完全一致
必须两边都执行:
SELECT @@gtid_mode, @@enforce_gtid_consistency;-
SELECT @@binlog_format;(必须是ROW,否则 GTID 不安全)
常见错误组合:
- 主库
ON/ 从库OFF→ 直接无法建立连接 - 主库
ON/ 从库ON_PERMISSIVE→ IO 线程能连上,但 SQL 线程执行时可能因事务缺失 GTID 报错 - 主库
ON/ 从库ON,但enforce_gtid_consistency = OFF→ 启动复制会失败,提示 “GTID consistency violated”
修改 gtid_mode 必须按顺序切换:OFF → OFF_PERMISSIVE → ON_PERMISSIVE → ON,跳步会报错。
确认 gtid_purged 和 binlog 是否覆盖从库需要的 GTID 区间
当从库报错类似 The slave requires GTIDs that the master has purged,说明主库已清理掉从库还没拉取的 binlog。这时不能只看 SHOW BINARY LOGS,还要比对:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 从库的
SELECT @@gtid_executed;(它“认为”自己已执行到哪) - 主库的
SELECT @@gtid_purged;(它“声明”已丢弃哪些) - 主库当前
SHOW MASTER STATUS中的Executed_Gtid_Set
如果从库的 gtid_executed 超出主库的 gtid_purged 范围,就只能重做从库,或者手动注入空事务补缺口 —— 但后者仅适用于单个 GTID 缺失,且必须先停掉两个线程:STOP REPLICA;,再用 SET GTID_NEXT='xxx:1'; BEGIN; COMMIT;。
STOP REPLICA 必须真正停干净才能改配置
MySQL 8.0 对复制状态校验极严。CHANGE MASTER TO 执行前,SHOW REPLICA STATUS\G 中 Replica_IO_Running 和 Replica_SQL_Running 都得是 No。常见卡点:
- SQL 线程正在回放一个大事务,
STOP REPLICA会挂住 → 改用STOP REPLICA SQL_THREAD;先停 SQL,等几秒再STOP REPLICA IO_THREAD; - IO 线程卡在认证阶段(比如主库账号密码变了但从库没更新)→ 查
Last_IO_Error,重点看是否含Access denied或caching_sha2_password相关提示 - 从库 relay log 目录磁盘满或权限不对 → 错误日志里会出现
Can't create/write to file '/var/lib/mysql/relay-log.000001'
真正停干净之后再改 gtid_mode、enforce_gtid_consistency,才不会触发 “This operation cannot be performed with a running replica”。
GTID 同步断裂往往不是单一参数问题,而是配置、状态、binlog 生命周期三者共同作用的结果。最容易被忽略的是:你以为改了 my.cnf 就生效了,其实 SET GLOBAL 只影响当前会话,重启后还原;而 RESET REPLICA ALL 会清空 gtid_executed,导致从库“忘记”自己执行过什么 —— 这种操作必须配合主库 gtid_purged 手动重设,否则一启就断。










