宝塔面板中mysql 5.7升8.0无真正平滑升级:需满足≥5.7.26、停服务、用宝塔升级按钮执行mysql_upgrade;导入备份必踩字符集、认证插件、系统库三坑;升级后须改配置、重置用户密码、调整sql模式,并提前用mysql-shell检查兼容性。

宝塔面板里 MySQL 5.7 到 8.0 没有真正“平滑”的一键升级路径——所谓“平滑”,是指数据不丢、服务不停、应用不改,但现实是:跨大版本升级必然涉及系统表结构、认证协议、字符集默认值、SQL 模式等底层变更,强行跳过检查或依赖逻辑导出导入,大概率导致网站白屏、后台登录失败、中文乱码或定时任务报错。
为什么 mysqldump 全库导入后网站连不上
执行 mysqldump --all-databases 再用 mysql 导入,表面成功,实际踩了三个硬坑:
- MySQL 5.7 默认字符集是
utf8(即utf8mb3),而 8.0 默认是utf8mb4;若导入时没加--default-character-set=utf8mb4,旧表的CHARSET=utf8会被隐式转成utf8mb4,但字段长度未扩容,后续插入超长中文直接截断或报错 - 用户认证插件从
mysql_native_password变为caching_sha2_password,宝塔创建的旧用户(包括 root)导入后无法通过 PHP 连接,报错Client does not support authentication protocol -
mysql系统库不能直接导入:8.0 删除了mysql.plugin表,mysql.user字段重构(如plugin、authentication_string类型变更),导入会中断并卡在第 12 张表
宝塔「升级」按钮到底靠不靠谱
宝塔 7.9+ 的「软件商店 → MySQL → 升级」功能,本质是调用官方 mysql_upgrade 工具做的原地二进制替换,不是重装,这才是唯一被验证可行的路径。但它有严格前提:
- 当前 MySQL 5.7 版本必须 ≥
5.7.26(低于此版本先升到 5.7.26,再升 8.0) - 必须提前停掉所有依赖 MySQL 的服务:PHP、网站、计划任务、Redis(若启用了 MySQL 监控)
- 升级包需匹配系统架构(
x86_64/aarch64)和 glibc 版本;宝塔提供的 RPM/DEB 包已适配 CentOS/Ubuntu,不要手动替换成官网源码编译版 - 升级前必须执行完整备份:
mysqldump -u root -p --all-databases --single-transaction --routines --events > full_backup.sql,并额外打包数据目录:tar -czf /www/backup/mysql_data_$(date +%F).tar.gz /www/server/data
升级完成后必须立刻改的三处配置
MySQL 8.0 启动成功 ≠ 网站能用。不调整以下三项,第二天就可能集体报错:
- 修改
/etc/my.cnf,在[mysqld]下追加两行:default_authentication_plugin=mysql_native_passwordcollation-server=utf8mb4_unicode_ci(避免 PHP 连接层因校验规则不匹配拒绝连接) - 重置所有业务用户密码,强制回退认证插件:
ALTER USER 'your_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_pass'; - 检查并清理旧 SQL 模式:8.0 默认启用
ONLY_FULL_GROUP_BY,若业务 SQL 有 SELECT 中带非 GROUP BY 字段,需在my.cnf的sql_mode中显式去掉该值,或改造代码
如何提前发现兼容性问题
别等升级完再修 bug。升级前务必用 MySQL Shell 检查:
- 下载对应 8.0 版本的
mysql-shell(如 8.0.27),上传至服务器 - 运行:
./mysqlsh -uroot -p -S /tmp/mysql.sock -e "util.checkForServerUpgrade()" - 输出日志中重点关注 ERROR 级别项:比如含
NO_AUTO_CREATE_USER的sql_mode、使用MyISAM的系统表、JSON 函数语法过时、保留关键字冲突的表名等 - 报告里的 WARNING 也要处理,例如
timestamp字段无默认值,在 8.0 会自动补时区,可能影响订单时间逻辑
真正的难点不在操作步骤,而在于你是否愿意花 20 分钟跑一次 util.checkForServerUpgrade(),并逐条核对它的输出——跳过这步,等于把问题留给凌晨三点的线上告警。











