MySQL主版本升级后必须执行mysql_upgrade并确认成功,否则会导致元数据异常;8.0.16+改由启动时自动升级,需查错误日志;辅以pt-table-checksum比对主从一致性、人工抽样验证关键数据、mysqlcheck检查物理完整性,并逐表核对字符集与排序规则变更。

检查 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 字段是否解析失败、时间字段是否因时区处理差异偏移。必须人工设计轻量级验证点。
citySHOP是一款集CMS、网店、商品、分类信息、论坛等为一体的城市多用户商城系统,已完美整合目前流行的Discuz! 6.0论坛,采用最新的5.0版PHP+MYSQL技术。面向对象的数据库连接机制,缓存及80%静态化处理,使它能最大程度减轻服务器负担,为您节约建设成本。多级店铺区分及联盟商户地图标注,实体店与虚拟完美结合。个性化的店铺系统,会员后台一体化管理。后台登陆初始网站密匙:LOVES
- 行数对比(注意:
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 值。









