双主复制环路必然导致Seconds_Behind_Master跳变、Duplicate entry报错和磁盘暴涨,核心是对方写入事务被本机重复执行;必须验证replicate_same_server_id=0生效、SOURCE_REPLICATE_IGNORE_SERVER_IDS正确配置对方UUID,并确保log_slave_updates=ON与之协同。

双主复制环路不是“可能出问题”,而是只要配置漏掉关键项,Seconds_Behind_Master跳变、Duplicate entry报错、磁盘暴涨就一定会发生。核心判断标准只有一条:对方写入的事务,在本机又被自己执行了一次。
看 SHOW REPLICA STATUS\G 里有没有循环迹象
别只盯着 Slave_IO_Running 和 Slave_SQL_Running 是不是 Yes——那只是线程活着,不是数据对得上。
-
Seconds_Behind_Master在 0 和几百之间反复跳变,不是网络抖动,是 SQL 线程在反复重放同一段 binlog -
Exec_Master_Log_Pos突然回退(比如从 12345 退到 9876),说明刚执行完一条事务,又从更早位置重放了 -
Retrieved_Gtid_Set和Executed_Gtid_Set差值持续扩大,且Executed_Gtid_Set里反复出现对方的server_uuid(比如 NodeB 的 UUID 出现在 NodeA 的 Executed_Gtid_Set 中) - 错误日志里有类似
Relay log read failure或Could not execute Write_rows_v1 event on table,但没明确报错行——这是循环写入导致 relay log 损坏的典型前兆
查 replicate-same-server-id = 0 是否真生效
这个参数是防环路的第一道闸门,但它不显式报错,设错等于没设。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 在两台机器上分别执行
SELECT @@replicate_same_server_id;,结果必须是0;如果返回1,说明配置没加载或被覆盖 - 确认它写在
[mysqld]段下,且没有被 Docker 启动参数、SET GLOBAL命令或 my.cnf.d/ 下其他文件覆盖 - MySQL 8.0.23+ 使用
replicate_same_server_id(下划线),不是replicate-same-server-id(短横线);拼错就无效 - 改完必须重启
mysqld,SET PERSIST不生效
验证 log_slave_updates = ON 和 SOURCE_REPLICATE_IGNORE_SERVER_IDS 配合是否正确
旧版本靠 replicate-same-server-id = 0 拦,新版本(8.0.23+)必须叠加 SOURCE_REPLICATE_IGNORE_SERVER_IDS 才真正干净。
- 先查双方
SELECT @@server_uuid;,记下 NodeA 和 NodeB 的完整 UUID 字符串(带短横线,如a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8) - 在 NodeA 上执行:
CHANGE REPLICATION SOURCE TO SOURCE_REPLICATE_IGNORE_SERVER_IDS = ('a1b2c3d4-e5f6-7890-g1h2-i3j4k5l6m7n8');—— 注意是填对方的 UUID,不是自己的 - 在 NodeB 上执行:
CHANGE REPLICATION SOURCE TO SOURCE_REPLICATE_IGNORE_SERVER_IDS = ('b9c8d7e6-f5a4-3210-h9i8-j7k6l5m4n3o2'); - 执行后必须
STOP REPLICA; START REPLICA;,运行中修改该参数不生效 - 检查是否生效:
SELECT * FROM performance_schema.replication_connection_configuration WHERE CHANNEL_NAME = 'default';,看SOURCE_REPLICATE_IGNORE_SERVER_IDS列是否显示对应 UUID
为什么 replicate_do_db 或 binlog_do_db 挡不住环路
很多人以为“我只让 A 同步 db_a,B 同步 db_b,就不会撞”,这是误解。这些参数只按库名过滤事件,不识别事件来源。
- NodeA 写
db_a→ binlog 记录为db_a→ NodeB 应用 →log_slave_updates = ON→ 写进 NodeB 自己的 binlog → NodeA 拉取 → 发现库名是db_a,匹配规则 → 又执行一遍 - 环路发生在 server_id 层,不是库名层;只要没关掉
replicate-same-server-id或没配SOURCE_REPLICATE_IGNORE_SERVER_IDS,库级过滤就是纸糊的墙 - 真正能隔离的只有两种方式:按
server_uuid过滤(推荐),或按库重写 + 业务严格分流(SOURCE_REPLICATE_REWRITE_DB)
最常被忽略的其实是 log_slave_updates 和 replicate-same-server-id 的配合关系:前者让链路成立,后者让链路不自噬。少一个,双主就不是高可用,是定时炸弹。

















