必须同时开启gtid_mode=ON和enforce_gtid_consistency=ON，否则GTID复制必然失败；前者是事务标识开关，后者是强制合规性闸门，缺一不可，且须写入my.cnf的[mysqld]段并重启生效。
必须开启 gtid_mode=ON 且同步启用 enforce_gtid_consistency=true，否则双主复制会在几分钟到几小时内断裂，不是“可能出问题”，而是“必然失败”。
为什么只开 gtid_mode=ON 不行
MySQL 启动时会校验这两个参数是否共存。如果只写 gtid_mode=ON 而漏掉 enforce_gtid_consistency=true，服务能启动，但一旦执行 CREATE TEMPORARY TABLE、NOW()、SYS_DATE() 这类非确定性语句，SQL 线程立刻报错中断，且无法自动恢复。
常见错误现象：
ERROR 1786 (HY000): Statement violates GTID consistency- 从库
Seconds_Behind_Master持续为NULL，Slave_SQL_Running_State卡在Waiting for executed GTID set to be empty
根本原因：GTID 要求所有事务可重放、无副作用，enforce_gtid_consistency=true 是强制开关，不是可选项。
binlog_format=ROW 是硬性前提，不是建议
双主环境下用 STATEMENT 或 MIXED 格式，等于埋定时炸弹。两台主库并发更新同一行时，STATEMENT 依赖执行顺序，而从库重放顺序无法保证一致，结果就是主从数据错位——查不到、多一条、值对不上，且无法通过 pt-table-checksum 发现。
必须确认：
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
-
SHOW VARIABLES LIKE 'binlog_format';返回值是ROW - 该配置写在
/etc/my.cnf的[mysqld]段，不是运行时SET GLOBAL - 重启
mysqld后验证SHOW MASTER STATUS;中的File名称是否变化（确认 binlog 已按新格式生成）
自增主键冲突的配置陷阱
默认 auto_increment_increment=1 + auto_increment_offset=1，两台主库同时插入，必然触发 ERROR 1062 (23000): Duplicate entry 'X' for key 'PRIMARY'。这不是概率问题，是确定性冲突。
正确配法（以两节点为例）：
- 节点 A：
auto_increment_increment=2，auto_increment_offset=1→ 生成 1, 3, 5… - 节点 B：
auto_increment_increment=2，auto_increment_offset=2→ 生成 2, 4, 6… - 这两项必须写入
my.cnf并重启生效；SET GLOBAL修改无效 - 已运行的库不能热改：需停写 →
ALTER TABLE t AUTO_INCREMENT = N对齐起始值 → 再重启
CHANGE MASTER TO 必须用 MASTER_AUTO_POSITION=1
GTID 模式下，MASTER_LOG_FILE 和 MASTER_LOG_POS 完全被忽略。如果误填了旧位置，SQL 线程不会报错跳过，而是卡死在 Waiting for gtid set to be executed，状态显示 Slave_IO_Running: Yes、Slave_SQL_Running: No，且 Seconds_Behind_Master 为 NULL。
正确操作只有一步：
CHANGE MASTER TO MASTER_HOST='192.168.1.101', MASTER_PORT=3306, MASTER_USER='repl', MASTER_PASSWORD='xxx', MASTER_AUTO_POSITION=1;
执行后立即 START SLAVE，再用 SHOW SLAVE STATUS\G 检查 Retrieved_Gtid_Set 和 Executed_Gtid_Set 是否持续增长——不增长就说明配置没生效或 GTID 参数根本没加载。
最容易被忽略的一点：所有 GTID 相关参数（gtid_mode、enforce_gtid_consistency、log_slave_updates）都必须写在 my.cnf 里并重启 mysqld；运行时设置只影响部分变量，对 GTID 模式本身完全无效。
