必须先运行pt-table-checksum生成校验数据，否则pt-table-sync因无percona.checksums表中DIFFS列而直接退出；报“No slaves were found”主因是主库未配置report_host或从库未出现在SHOW SLAVE HOSTS中，需加--recursion-method=dsn显式指定从库地址或在主库配置report_host并重启。
必须先跑 pt-table-checksum，否则 pt-table-sync 直接退出——它不比对数据，只读 percona.checksums 表里的 DIFFS 列。
为什么执行就报 “No slaves were found”？
这是最常卡住的第一步。主库没设 report_host，或从库未在主库的 SHOW SLAVE HOSTS 里出现，pt-table-checksum 就发现不了从库。
- 临时解法：加
--recursion-method=dsn显式指定从库地址，例如D="h=192.168.184.152,u=dba,p=Id81Gdac_a" - 根治方法：在主库配置文件中加
report_host=192.168.184.150（填主库自身可被从库访问的 IP），并重启 MySQL - 注意：
pt-table-sync同样依赖这个发现机制，所以这步不解决，后续所有命令都会跳过从库
修复前必须确认的三件事
别急着 --execute。很多线上事故源于忽略这三项：
MySQL8 CRM Schema Design Expert
下载
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
-
SHOW SLAVE STATUS\G中Slave_IO_Running和Slave_SQL_Running必须都是Yes；若任一为No，说明复制链路已断，不是“不一致”，是“没在同步” -
Seconds_Behind_Master不能为NULL（大概率 SQL 线程卡死）；持续 > 0 且缓慢增长，说明是真实延迟，但未必是数据不一致 - 真正铁证是
Last_SQL_Error出现Can't find record in 'xxx'或Duplicate entry—— 这时才该用pt-table-sync
怎么安全生成并验证修复语句？
pt-table-sync 不是“执行器”，它是“SQL 生成器”。跳过 --print 直接 --execute，等于让工具在生产库上盲发 DELETE/REPLACE。
- 必加参数：
--print --replicate=percona.checksums --sync-to-master；其中--sync-to-master表示所有修改都在主库执行，靠复制同步到从库，避免直写从库引发断裂 - 示例命令：
pt-table-sync --print --replicate=percona.checksums --sync-to-master h=192.168.184.152,u=dba,p=Id81Gdac_a --databases=maria - 输出里看到
DELETE FROM `maria`.`t_user` WHERE id = 123时，先人工判断：这是从库多出的脏数据，还是业务双写遗留的合法记录？尤其涉及订单、资金类表，建议手动START TRANSACTION执行几条验证逻辑和权限
遇到 “Cannot chunk table” 怎么办？
表没有主键或唯一索引，或字符型主键前缀高度重复（如全以 U_ 开头），pt-table-sync 默认拒绝分块，直接报错退出。
- 典型报错：
Cannot chunk table dbname.opt_log using the character column opt_id, most likely because all values start with the same character - 临时绕过：
--algorithms=Nibble（逐行扫描，慢但能过），或--no-check-plan（跳过计划检查，风险自担） - 根治方法：
ALTER TABLE dbname.opt_log ADD id BIGINT AUTO_INCREMENT PRIMARY KEY FIRST；加主键前务必确认字段类型兼容现有数据，避免Incorrect integer value类错误
真正容易被忽略的点是：修复后必须立刻重跑一次 pt-table-checksum，确认所有表的 DIFFS 都变回 0；同时检查涉及表是否有触发器、外键约束——老版本 MySQL 的外键可能干扰 ON DUPLICATE KEY UPDATE 语义，导致修复结果与预期不符。
