检查 mysql_upgrade
是否已执行且无报错
MySQL 主版本升级(如 5.7 → 8.0)后,系统表结构可能变更,
mysql_upgrade是官方推荐的元数据兼容性修复工具。它不校验业务数据,但若跳过或失败,会导致
INFORMATION_SCHEMA视图异常、权限失效、甚至
SELECT COUNT(*)返回错误结果。 必须在升级后、应用访问前执行:
mysql_upgrade -u root -p --force留意输出末尾是否含
Upgrade process completed successfully;若出现
ERROR 1872或反复提示某张表损坏,说明底层数据字典已不一致,需先用
mysqld --upgrade=NONE启动并导出再重建 MySQL 8.0.16+ 已弃用该命令,改由服务启动时自动执行;此时应检查错误日志中是否有
Auto-upgrade complete或
Failed to upgrade data dictionary
用 pt-table-checksum
做主从/跨实例一致性比对
如果升级涉及主从切换或迁移至新实例,
pt-table-checksum(Percona Toolkit)是最实用的在线一致性校验工具。它通过分块计算 CRC32 校验和,在主库生成摘要,再让从库执行相同逻辑并比对,避免全表锁和网络拉取全部数据。 确保主从 binlog_format = ROW,且从库 SQL 线程未延迟(
Seconds_Behind_Master = 0) 基础命令示例:
pt-table-checksum --host=localhost --user=root --password=xxx --databases=mydb --no-check-binlog-format关键参数注意:
--chunk-size过大会触发超时,
--max-load可防主库压力突增;若校验中报
Column count mismatch,说明某张表在新旧版本间字段定义被隐式修改(如
TIMESTAMP默认值行为变化),需人工核对
SHOW CREATE TABLE输出
抽样比对关键表的行数、聚合值与边界数据
自动化工具无法覆盖所有语义逻辑,比如金额字段是否被截断、JSON 字段是否解析失败、时间字段是否因时区处理差异偏移。必须人工设计轻量级验证点。
行数对比(注意:SELECT COUNT(*)在大表上不准,优先用
TABLE_ROWS,但仅适用于 InnoDB 估算值):
SELECT table_name, table_rows FROM information_schema.tables WHERE table_schema='mydb' AND table_name IN ('orders','users');
聚合值抽查:对比升级前后同条件下的 SUM(amount)、
AVG(score),特别注意浮点数字段是否因 MySQL 8.0 的
DECIMAL精度策略变更导致微小偏差 边界数据验证:查
ORDER BY created_at DESC LIMIT 1和
MIN(id), MAX(id),确认自增列、时间戳未重置或翻转;若发现
created_at出现
'0000-00-00 00:00:00',说明 sql_mode 中
NO_ZERO_DATE生效,需清理或调整配置
运行 mysqlcheck
检查表物理完整性
mysqlcheck是 MySQL 自带的表维护工具,可检测索引损坏、页断裂、B+树节点异常等底层问题。升级过程若中断或磁盘 I/O 异常,可能导致 .ibd 文件损坏,而这种损坏不会立刻暴露,后续 DML 才会触发
ERROR 2013或崩溃。 执行前停止写入,或加
--parallel降低影响:
mysqlcheck -u root -p --check --all-databases --medium-check
--medium-check会校验索引树结构和行记录链接,比
--quick更彻底;若返回
error : record is crashed,说明该表已损坏,不能直接
REPAIR(InnoDB 不支持),只能从备份恢复或用
mysqldump --single-transaction导出重建 注意:MySQL 8.0 对
mysqlcheck的
--optimize行为有变更,不再默认重建表,需显式加
--alter才触发 ALGORITHM=INPLACE 实际中最容易被忽略的是字符集与排序规则的隐式升级行为——比如原库用
utf8mb4_general_ci,升级到 8.0 后
information_schema.COLLATION_NAME显示为
utf8mb4_0900_as_cs,但表定义没变,导致
WHERE name = 'abc'结果不一致。这类问题必须在验证清单里单列一条:用
SHOW FULL COLUMNS FROM t1和
SHOW CREATE TABLE t1逐表比对
COLLATE值。
