必须在主库执行,且结果须查从库的percona.checksums表才能判断是否真一致:因工具依赖statement复制将校验语句重放到从库执行并本地计算,命令行Diffs=0仅表示主库写入无冲突,非主从比对结果;跳过无主键/唯一非空索引表、ROW模式需加--no-check-binlog-format、权限缺失或复制过滤均会导致漏检。

必须在主库执行,且结果要查从库的 percona.checksums 表才能判断是否真一致——命令行末尾显示 Diffs = 0 完全不可信。
为什么不能直连从库执行 pt-table-checksum
工具设计上就是主库驱动:它在主库生成带 CRC32 计算的 REPLACE INTO ... SELECT 语句,依赖 binlog 复制到从库重放并本地再算一次。若用 --host=从库IP 强行指向从库,会触发以下问题:
- 尝试在从库执行
SHOW PROCESSLIST、修改binlog_format等主库专属操作,大概率卡住或报Cannot connect to host - 从库通常禁用
SUPER权限、禁止写入,而工具需要INSERT/UPDATE权限往percona.checksums写数据 - 复制过滤规则(如
replicate_ignore_db)可能跳过percona.checksums表同步,导致从库根本没这条记录
percona.checksums 表在哪查、怎么看才有效
校验完成后,必须手动登录每个从库,运行这条查询:
SELECT db, tbl, chunk, this_crc, master_crc, is_bad FROM percona.checksums WHERE this_crc != master_crc OR is_bad = 1;
注意几个关键点:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
-
Diffs列为 0 ≠ 一致:命令行输出的Diffs只反映“主库写 checksums 表时有没有冲突”,不是主从比对结果 - 如果某张表在
pt-table-checksum执行期间完全没被 DML 触发 binlog 更新,它的记录就不会同步到从库——DIFFS=1很可能是漏同步,不是真不一致 - 从库延迟高、SQL 线程中断、
Seconds_Behind_Master > --max-lag都会导致percona.checksums表未及时更新,查出来全是空
哪些表会被静默跳过,却不会报错
没有主键或唯一非空索引的表,pt-table-checksum 会直接跳过,日志里只写一句 Cannot chunk table without a primary key or unique not null index,但返回码仍是 0,极易被忽略。
- 用这条 SQL 提前筛查:
SELECT TABLE_SCHEMA, TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA NOT IN ('information_schema','mysql','performance_schema') AND TABLE_NAME NOT IN (SELECT TABLE_NAME FROM information_schema.KEY_COLUMN_USAGE WHERE CONSTRAINT_NAME='PRIMARY' OR (CONSTRAINT_NAME!='PRIMARY' AND NON_UNIQUE=0)) GROUP BY TABLE_SCHEMA, TABLE_NAME; -
TEXT/BLOB字段参与CRC32计算时可能被截断(受max_allowed_packet限制),建议加--ignore-columns排除 - 复合主键中含
NULL值的列会导致分块边界错乱,务必确保所有主键列定义为NOT NULL
binlog_format = ROW 下必须加 --no-check-binlog-format
MySQL 5.7+ 默认 binlog_format = ROW,而 pt-table-checksum 原生只支持 STATEMENT 或 MIXED 模式。不加参数会直接退出,并报类似 Cannot replicate statement because it uses row-based replication 的错误。
- 加了
--no-check-binlog-format后,工具会强制走 ROW 模式下发校验语句,但需确认从库能安全执行(例如避免NOW()、UUID()等非确定性函数) - 若主库开了
require_secure_transport=ON,命令必须加--ssl,否则 SSL 握手失败 - 账号权限缺一不可:
REPLICATION CLIENT(查从库状态)、PROCESS(看线程)、SELECT(读表)、INSERT/UPDATE/DELETE(写percona.checksums)
真正容易被忽略的是:校验不是“跑完命令就完事”,而是“主库写、从库收、人工查”。只要少查一个从库、少看一行 this_crc != master_crc,就等于把一致性漏洞留在生产环境里。

















