pt-table-checksum要求外键字段必须有索引，因其默认按主键或唯一索引分块校验；若外键列无索引，JOIN时将触发全表扫描，导致超时、锁表或直接报错“Cannot chunk table”。

外键字段没索引，pt-table-checksum 直接报错退出，校验根本跑不起来。

为什么 pt-table-checksum 要求外键字段必须有索引

这个工具默认按主键或唯一索引切分数据块（chunk），但如果 JOIN 涉及的外键列没索引，它就无法高效定位关联行 —— 尤其在 JOIN 查询中用到 table2.foreign_key = table1.primary_key 时，若 table2.foreign_key 没索引，从库执行 checksum 计算就会触发全表扫描，不仅慢，还可能被超时中断或锁表。

• pt-table-checksum 不会自动为你建索引，也不会跳过无索引外键表
• 即使主表有主键、从表有主键，只要 JOIN 条件里用了未索引的外键列，校验就会降级成低效路径
• 错误典型提示：Cannot chunk table `db`.`table2`: Cannot find a good index for chunking

如何快速确认并补全缺失的外键索引

别猜，直接查。MySQL 不会把外键和索引自动绑定，外键约束存在 ≠ 外键字段已索引。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

• 查哪些外键没索引：

  SELECT
    CONSTRAINT_NAME,
    TABLE_NAME,
    COLUMN_NAME,
    REFERENCED_TABLE_NAME,
    REFERENCED_COLUMN_NAME
  FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE
  WHERE CONSTRAINT_SCHEMA = 'your_db'
    AND REFERENCED_TABLE_NAME IS NOT NULL
    AND CONCAT(TABLE_NAME, '.', COLUMN_NAME) NOT IN (
      SELECT CONCAT(TABLE_NAME, '.', COLUMN_NAME)
      FROM INFORMATION_SCHEMA.STATISTICS
      WHERE TABLE_SCHEMA = 'your_db'
    );
  

• 对结果里的每一对 TABLE_NAME / COLUMN_NAME，补索引：

  CREATE INDEX idx_table2_user_id ON table2(user_id);
  

• 注意：复合外键（如 (a,b)）要建联合索引，单列索引无效

校验前必须检查的三个隐性条件

光有索引还不够。以下任一不满足，pt-table-checksum 都可能跳过表、误判不一致，甚至损坏数据。

• 主从表结构必须完全一致：包括字段顺序、字符集、COLLATE、NOT NULL 属性 —— SHOW CREATE TABLE 对比最可靠
• 从库不能有 replicate_ignore_table 或 replicate_wild_ignore_table 过滤掉待校验表
• pt-table-checksum 默认只校验有主键或唯一索引的表；如果某表靠外键关联但自身无主键，得加 --no-check-plan 并手动指定索引列，风险自担

校验时要不要关外键约束

不需要，也不建议关。外键约束本身不影响 pt-table-checksum 的读操作；它只做 SELECT 和 CRC32 计算，不写数据。但如果你后续要用 pt-table-sync 修复，就得注意：

• pt-table-sync 默认在主库生成 REPLACE 或 DELETE/INSERT 语句，再通过复制同步到从库 —— 这个过程依赖外键约束是否开启，否则从库可能插入孤儿记录
• 线上环境禁止临时 SET FOREIGN_KEY_CHECKS=0，除非你确认所有变更都绕过一致性校验逻辑
• 真正影响速度的是索引缺失，不是外键开关；把索引补全，比纠结开关快一个数量级

最容易被忽略的一点：外键索引不是“建了就完事”。如果外键字段类型和主键不一致（比如主键是 BIGINT，外键是 INT），MySQL 会隐式转换，索引失效，pt-table-checksum 同样会退化。务必用 SHOW COLUMNS 核对两边字段类型是否字节级一致。