从MySQL 7升级到MySQL 8的避坑指南与实操指南

前言

MySQL 8 作为里程碑式的版本，带来了诸多重磅特性（如窗口函数、CTE、更强的 JSON 支持、默认 UTF8MB4 编码、性能优化等），但从 MySQL 7（注：MySQL 官方无 “7” 正式版，通常指 5.7，下文统一以 5.7 代指）升级并非 “一键无脑更”，涉及语法、配置、权限、数据类型等多维度兼容问题。本文结合实战经验，梳理升级核心注意事项、实操步骤与常见坑点，帮你平稳完成升级。

一、升级前必看：核心兼容性差异

1. 默认字符集与排序规则变更

• MySQL 5.7：默认字符集为latin1，排序规则latin1_swedish_ci；
• MySQL 8.0：默认字符集改为utf8mb4，排序规则utf8mb4_0900_ai_ci（基于 Unicode 9.0，区分语言特性）。
• 风险点：若原库未显式指定字符集，升级后可能出现乱码、排序异常；若业务依赖latin1，需提前规划字符集迁移。
• 建议：升级前全库检查字符集，执行SELECT table_schema, table_name, column_name, character_set_name FROM INFORMATION_SCHEMA.COLUMNS WHERE character_set_name != ‘utf8mb4’;，提前将核心表字段改为utf8mb4。

2. 认证插件与密码策略变更

• MySQL 5.7：默认认证插件为mysql_native_password；
• MySQL 8.0：默认改为caching_sha2_password，且强化了密码策略（默认要求密码长度≥8、包含大小写 / 数字 / 特殊字符）。
• 风险点：
  旧客户端（如 PHP5.x、Python2.x）不支持caching_sha2_password，会导致连接失败；
  原弱密码用户升级后可能无法登录。
• 建议：
  若需兼容旧客户端，可临时改回旧认证插件：ALTER USER ‘user’@‘%’ IDENTIFIED WITH mysql_native_password BY ‘new_password’;；
  升级前梳理所有数据库用户，提前更新弱密码，避免升级后登录失败。

3. 系统表与数据字典重构

• MySQL 8 彻底移除了 MyISAM 存储的系统表，改用 InnoDB 的事务型数据字典，mysql库结构大幅调整：
• 原mysql.user/mysql.db等权限表变为视图，直接修改表的操作（如INSERT INTO mysql.user）失效；
• 不再支持mysql_upgrade（5.7 升级 8.0 需用mysqld --upgrade=FORCE）；
• 移除information_schema中部分冗余表（如INNODB_SYS_*）。
• 建议：检查业务中是否有直接操作系统表的 SQL，改为官方推荐的CREATE USER/GRANT等语法。

4. SQL 模式与语法兼容性

• 默认 SQL 模式增强：MySQL 8 默认启用ONLY_FULL_GROUP_BY、STRICT_TRANS_TABLES等，5.7 中未开启的严格模式可能导致原有 “不规范 SQL” 执行失败（如 GROUP BY 中未包含非聚合字段）；
• 关键字新增：MySQL 8 新增ROLE、WINDOW、CTE等关键字，若表名 / 字段名与这些关键字重名（如CREATE TABLE role (id INT);），需加反引号`包裹；
• 函数行为变更：NOW()、SYSDATE()等函数精度提升，JSON_EXTRACT语法更严格，旧 JSON 操作 SQL 可能报错。

5. 存储引擎与功能移除

• 移除QUERY_CACHE（查询缓存）：MySQL 8 彻底删除查询缓存功能，若 my.cnf 中配置了query_cache_type、query_cache_size等参数，启动会报错；
• 移除NO_AUTO_CREATE_USER SQL 模式：5.7 中GRANT语句若未指定密码会自动创建用户，8.0 中此行为被禁止，需先CREATE USER再授权；
• 不支持MYSQL40密码格式：仅保留MYSQL56和caching_sha2_password，极旧的用户密码需重置。

二、升级实操：分步执行（推荐离线升级）

步骤 1：升级前准备

1. 全量备份：使用mysqldump或物理备份工具（如 xtrabackup）备份整个数据库，命令示例：

# 全量备份（包含存储过程、触发器、事件）
mysqldump -uroot -p --all-databases --routines --triggers --events > mysql57_full_backup.sql

2. 环境检查

• 确认服务器系统满足 MySQL 8 要求（如 glibc≥2.17、libaio≥0.3.109）；
• 检查 my.cnf 配置文件，删除query_cache_*、innodb_large_prefix等 8.0 废弃的参数；

3. 兼容性检测：使用 MySQL 官方工具mysqlcheck或第三方工具（如 Percona Toolkit）扫描 SQL 兼容性：

# 检查单库语法兼容性
pt-upgrade --source h=127.0.0.1,P=3306,u=root,p=xxx,D=test --dest h=127.0.0.1,P=3307,u=root,p=xxx

步骤 2：停止旧库，安装 MySQL 8

1.停止 MySQL 5.7 服务：

systemctl stop mysqld

2.卸载旧版本（保留数据目录）：

yum remove mysql-community-server-5.7*

3.安装 MySQL 8（以 CentOS 为例）：

# 配置yum源
wget https://dev.mysql.com/get/mysql80-community-release-el8-3.noarch.rpm
rpm -ivh mysql80-community-release-el8-3.noarch.rpm
# 安装服务
yum install mysql-community-server -y

步骤 3：初始化与升级数据

1.启动 MySQL 8 并强制升级数据字典：

# 启动并执行升级
mysqld --upgrade=FORCE --user=mysql &

2.检查升级日志（/var/log/mysqld.log），确认无报错：

grep "upgrade" /var/log/mysqld.log

3.重置 root 密码（MySQL 8 初始密码在日志中，且默认要求强密码）：

# 查看初始密码
grep "temporary password" /var/log/mysqld.log
# 登录后重置
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NewPass@123';

步骤 4：验证与适配

1. 检查数据库连接：验证业务程序、客户端工具能否正常连接；
2. 执行核心 SQL：运行业务关键 SQL（如查询、插入、更新），检查是否有语法报错；
3. 性能监控：观察 CPU、内存、IO 使用率，对比升级前性能，若有下降需优化配置（如调整innodb_buffer_pool_size）。

三、常见坑点与解决方案

四、总结

MySQL 5.7 升级到 8.0 的核心是 “先兼容检查，再分步升级，最后验证适配”：

• 升级前重点关注字符集、认证插件、SQL 语法、废弃参数四大兼容性问题；
• 务必全量备份，推荐先在测试环境验证，再落地生产；
• 升级后优先检查核心业务 SQL 执行情况，及时调整配置和代码适配新特性。
• MySQL 8 的新特性能显著提升业务性能和开发效率，只要做好充分的兼容性评估，就能平稳完成升级，享受新版本带来的红利。

核心注意点回顾

1.兼容性核心：MySQL 8 的字符集（utf8mb4 默认）、认证插件（caching_sha2_password）、SQL 模式是最易出问题的三大点，需提前适配；

2.操作关键：升级前必须全量备份，测试环境验证是避坑的核心，禁止直接在生产环境 “裸升”；

3.适配重点：移除废弃配置（如查询缓存）、优化不规范 SQL（如 GROUP BY）、升级老旧客户端，确保连接和执行正常。

以上就是从MySQL 7升级到MySQL 8的避坑指南与实操指南的详细内容，更多关于MySQL 7升级到MySQL 8的资料请关注脚本之家其它相关文章！

最新评论