必须先确认主从数据真不一致而非延迟假象:登录从库执行SHOW SLAVE STATUS\G,检查Slave_IO_Running和Slave_SQL_Running均为Yes、Seconds_Behind_Master非NULL,再以Last_SQL_Error出现“Can't find record”或“Duplicate entry”为硬证据;仅Seconds_Behind_Master=120属正常延迟,需等待追平。

确认主从状态是否真不一致,而非延迟假象
直接执行修复前,必须排除复制延迟干扰。登录从库运行 SHOW SLAVE STATUS\G,盯住三项:Slave_IO_Running 和 Slave_SQL_Running 必须都为 Yes;Seconds_Behind_Master 不能为 NULL(那是 SQL 线程已卡死);真正不一致的硬证据是 Last_SQL_Error 出现 Can't find record in 'xxx' 或 Duplicate entry。如果只是 Seconds_Behind_Master = 120,先等它追上,别急着修。
pt-table-sync 必须依赖 pt-table-checksum 的校验结果
pt-table-sync 不自己比数据,它只读 percona.checksums 表里的差异标记。所以必须先在主库跑完 pt-table-checksum,且确保从库能查到这张表。常见失败点包括:
- 主库账号缺
REPLICATION CLIENT权限,导致无法获取 binlog 位置 - 从库账号没
SELECT权限,读不了percona.checksums - 输出里出现
No slaves were found,大概率是主库没配report_host,得加--recursion-method=dsn手动指定从库地址 -
DIFFS列为1才代表该表存在行级差异;若ERRORS非 0,先检查表结构、字符集、排序规则是否完全一致
用 --print 预览修复语句,再决定是否 --execute
永远不要跳过 --print。命令示例:pt-table-sync --print --replicate=percona.checksums --sync-to-master h=192.168.184.152,u=dba,p=Id81Gdac_a --databases=maria。关键点:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
--sync-to-master表示所有修复操作都在主库执行(如REPLACE INTO),再靠复制同步到从库——这是最安全模式,避免直写从库引发后续断裂 - 输出里看到大量
DELETE FROM xxx WHERE ...或INSERT ... ON DUPLICATE KEY UPDATE,要人工核对是否符合业务预期 - 如果输出语句中主键条件含
NULL或字段类型明显错位,说明表缺少唯一索引或主键,pt-table-sync会失效 - 确认无误后,把
--print换成--execute才真正执行
修复后必须验证,且警惕外键与触发器
修复完不是终点。立刻做三件事:
- 从库执行
SHOW SLAVE STATUS\G,确认Seconds_Behind_Master = 0且Last_SQL_Error为空 - 重新跑一次
pt-table-checksum,确保所有表的DIFFS都回到0 - 重点检查被修复的表:若有外键约束,MySQL 8.0+ 虽将外键逻辑上移到 SQL 层,但老版本仍可能因级联动作导致意外变更;若有触发器,需确认其在主库执行修复语句时是否被触发并产生副作用
最易忽略的是修复过程本身对主库 binlog 的放大——一条 REPLACE 可能生成多条事件,若主库负载高或从库回放慢,反而加剧延迟。所以别在业务高峰跑 --execute。










