MySQL迁移是业务架构调整或服务器升级过程中常见的操作，迁移完成后如果数据一致性校验失败，意味着源库和目标库的数据存在差异，可能会引发业务逻辑错误、数据丢失等严重问题。pt-table-checksum作为成熟的数据校验工具，能够高效完成迁移前后的数据一致性核对工作。
pt-table-checksum工作原理
pt-table-checksum通过在源库上执行分块校验的方式，对指定的表数据进行哈希计算，将每个数据块的校验值同步到目标库进行对比。它不会对线上业务造成过大压力，支持指定校验的数据库、表，也支持过滤不需要校验的数据范围。
核心校验逻辑
工具会对表按照主键或者唯一索引进行分块，对每个块内的所有行数据计算一个CRC32校验值，然后将源库的校验值和目标库的对应校验值进行对比，如果不一致则说明该数据块存在数据差异。
使用pt-table-checksum校验迁移数据的步骤
1. 环境准备
首先需要确保已经安装Percona Toolkit，同时迁移的源库和目标库之间网络连通，并且用于执行校验的数据库账号具备相应的权限，包括SELECT权限、REPLICATION CLIENT权限、PROCESS权限等。
2. 执行校验命令
假设源库地址为192.168.0.1，端口3306，目标库地址为192.168.0.2，端口3306，校验db1数据库下的所有表，执行命令如下：
pt-table-checksum --host=192.168.0.1 --port=3306 --user=check_user --password=check_pass --databases=db1 --replicate=percona.checksums --recursion-method=hosts
命令参数说明：
--host：指定源库地址--port：指定源库端口--user：指定数据库账号--password：指定数据库密码--databases：指定需要校验的数据库，多个数据库用逗号分隔--replicate：指定存储校验结果的表--recursion-method：指定获取目标库信息的方式，这里使用hosts方式获取目标库地址
3. 查看校验结果
校验完成后，可以查询存储校验结果的表来查看是否存在数据不一致的情况，执行SQL如下：
SELECT db, tbl, SUM(this_cnt <> master_cnt) AS cnt_diff, SUM(this_crc <> master_crc) AS crc_diff FROM percona.checksums WHERE master_cnt <> this_cnt OR master_crc <> this_crc GROUP BY db, tbl;
如果查询结果返回空，说明所有校验的表数据一致，如果存在记录，则说明对应的表存在数据差异。
数据一致性校验失败的常见原因及解决方法
1. 迁移过程中源库有数据写入
如果迁移过程中没有停止源库的写入操作，或者没有开启正确的迁移同步机制，就会导致迁移过程中源库新增的数据没有同步到目标库，出现校验失败。
解决方法：如果是全量迁移场景，建议在迁移前开启只读模式，或者在迁移过程中使用支持增量同步的工具，确保源库的所有变更都能同步到目标库，完成全量迁移后再进行增量追平，最后执行校验。
2. 迁移工具本身存在数据转换问题
部分迁移工具在处理特殊数据类型、字符集、时区等场景时可能出现数据转换错误，导致目标库数据和源库不一致。
解决方法：先定位差异表的具体差异行，对比源库和目标库对应行的字段值，确认是否是数据类型转换导致的问题。如果是字符集问题，需要统一源库和目标库的字符集配置；如果是时区问题，需要统一数据库的时区设置，然后重新迁移差异表的数据。
3. 目标库存在数据损坏
如果目标库的存储引擎出现问题，或者迁移过程中目标库服务出现异常中断，可能导致部分数据写入失败或者损坏。
解决方法：先检查目标库的错误日志，确认是否存在存储引擎相关的错误。如果是少量表的数据损坏，可以重新从源库导出对应表的数据，覆盖导入到目标库，然后重新执行校验。
4. 校验参数配置错误
如果pt-table-checksum的参数配置错误，比如指定的目标库地址不正确、过滤条件错误，也会导致校验结果异常。
解决方法：检查校验命令的参数配置，确认--recursion-method获取的目标库地址是否正确，是否需要添加--where参数过滤不需要校验的数据，调整参数后重新执行校验。
差异数据修复方法
确认数据差异后，可以使用pt-table-sync工具来修复目标库的不一致数据，该工具也是Percona Toolkit的组成部分，能够根据pt-table-checksum的校验结果，自动生成修复目标库数据的SQL语句。
生成修复语句的命令示例如下：
pt-table-sync --execute --replicate=percona.checksums --host=192.168.0.1 --port=3306 --user=check_user --password=check_pass
执行前建议先去掉--execute参数，查看生成的SQL语句是否符合预期，确认无误后再添加参数执行修复，修复完成后重新执行pt-table-checksum校验，直到所有表数据一致。
MySQL迁移数据一致性校验pt-table-checksum修改时间：2026-06-24 21:15:35