迁移前必须启用row格式binlog并配置server-id;迁移中需精确定位binlog位点,禁用自动清理;迁移后须分层验证binlog完整重放,不可仅依赖行数一致。

迁移前必须确认 binlog 已启用且格式为 ROW
如果源库没开 log-bin,或用了 STATEMENT 格式,迁移时就可能漏掉某些变更——比如带函数、触发器、非确定性 SQL 的操作,在 STATEMENT 模式下无法被准确重放。
检查方式很简单:
- 执行
SHOW VARIABLES LIKE 'log_bin';,返回ON才算开启 - 执行
SHOW VARIABLES LIKE 'binlog_format';,必须是ROW(不是MIXED或STATEMENT) - 确认
server-id已在配置中设置且不为 0(主从复制场景必需)
若发现未启用,需重启 MySQL 并追加以下配置:
log-bin = /var/log/mysql/mysql-bin.log binlog-format = ROW server-id = 1
迁移期间不能跳过 binlog 位点或依赖“全量 dump + 忽略增量”
常见错误是:用 mysqldump 导出后直接导入目标库,然后认为“数据已齐”,却完全忽略 dump 时刻之后、切换前产生的新写入。这些写入只存在于源库的 binlog 中,一旦没捕获,就永久丢失。
正确做法取决于迁移方式:
- 若走逻辑迁移(
mysqldump),必须配合--master-data=2参数,它会在导出 SQL 头部插入类似CHANGE MASTER TO MASTER_LOG_FILE='mysql-bin.000003', MASTER_LOG_POS=12345;的注释,标记 dump 时的精确 binlog 位置 - 若走主从复制迁移,需在目标库启动复制前,用
SHOW MASTER STATUS;记录源库当前File和Position,再在目标库执行CHANGE REPLICATION SOURCE TO ...(MySQL 8.0.23+)或CHANGE MASTER TO ...(旧版)对齐起点 - 禁止手动修改
MASTER_LOG_POS到一个“大概值”,哪怕只差 1 字节,也可能跳过一条INSERT或导致解析失败
迁移后必须验证 binlog 是否被完整消费或重放
光有 binlog 文件不等于数据已同步;关键要看目标端是否真正应用了全部事件。尤其是使用 pt-table-sync 或自定义脚本做差异修复时,容易误以为“行数一致就完事”,但 binlog 里可能包含 DDL(如 ALTER TABLE)、权限变更、甚至 CREATE USER,这些不会体现在行数对比中。
验证建议分层进行:
- 基础层:对比源库
SHOW MASTER STATUS;和目标库SHOW REPLICA STATUS\G(或SHOW SLAVE STATUS\G)中的Seconds_Behind_Master是否为0,且Read_Master_Log_Pos == Exec_Master_Log_Pos - 语义层:对关键表执行
CHECKSUM TABLE t1;(注意该命令会锁表,慎用于大表),比对源/目标结果是否一致 - 日志层:用
mysqlbinlog --base64-output=DECODE-ROWS -v mysql-bin.000003 | grep -A 5 "your_table_name"抽样查看源库 binlog 中的变更,再查目标库对应时间点的 binlog(如有)或查询结果是否匹配
最容易被忽略的是 binlog 过期策略与磁盘空间
很多线上库设置了 expire_logs_days = 7 或 binlog_expire_logs_seconds = 604800,迁移耗时超过这个期限,binlog 就会被自动 purge——尤其当迁移卡在验证或回滚阶段时,没人留意日志已被清空。
临时应对措施要立刻执行:
- 迁移窗口期内,先执行
SET GLOBAL binlog_expire_logs_seconds = 0;(MySQL 8.0.28+)或SET GLOBAL expire_logs_days = 999;(旧版),禁用自动清理 - 确认磁盘剩余空间 ≥ 当前 binlog 总大小 × 2(留足重放和归档冗余)
- 迁移完成、确认目标库稳定运行至少 24 小时后,再恢复原有过期策略
真正危险的不是技术复杂度,而是把 binlog 当成“辅助日志”而非“唯一事实来源”——只要它断了、跳了、删了,哪怕其他环节全对,数据也已经残缺。











