宝塔面板怎么切换 MySQL 版本?备份、卸载、重装、导入四步完成
宝塔面板切换 MySQL 版本,不是直接在软件商店里卸载再装那么简单——切换会清空面板里已有的数据库,所以在动手前必须先做完整备份。正确顺序是:记录数据库账号信息 → 备份每个数据库并下载到本地 → 删除数据库、卸载旧版 → 安装目标版本 → 重建用户并导入备份 → 验证版本和网站。
下面按官方文档的步骤,把每一步讲清楚。
为什么切换前必须先备份
宝塔面板切换 MySQL 版本时通常会有「跨版本切换存在数据丢失风险」的提示,这不是吓唬人。切换流程是先卸载旧版 MySQL,而卸载不会自动保留数据库,所以只要跳过备份,已有的库就没了。
除了用面板备份数据库,还建议在云厂商控制台(阿里云、腾讯云、华为云等)给服务器创建快照或系统镜像,多留一层兜底。另外切换过程中 MySQL 无法使用,请选在业务低峰期操作。
切换前要记下三样信息
进面板左侧【数据库】管理页面,把每个数据库的信息记到本地,格式大致如下:
| 数据库名 | 用户名 | 密码 |
|---|---|---|
| bt.cn | bt.cn | f8DArwY7RPr2ynbp |
| website_db | web_user | Kx9mNp2qR7sT |
| shop_db | shop_user | Lm5pQw8rE3tY |
要依次记录每一个数据库的库名、用户名和密码,恢复时这三个必须和原来一致。同时点【root密码】按钮,把 root 密码也记下来。
第一步:备份所有数据库并下载到本地
在数据库列表里,逐个点击每个数据库后面的【点击备份】按钮,进入后点【备份数据库】等待完成,再点【下载】把备份文件下载到本地保存。

这一步是整条流程的安全底线:本地备份文件是切换失败时最直接、最可靠的兜底,别只留在服务器上。
第二步:删除数据库、卸载旧版 MySQL
确认备份都已下载到本地后,再往下走:
- 回到【数据库】页面,逐个点击每个数据库后的【删除】按钮;
- 进【软件商店】,找到当前安装的 MySQL 版本,点击【卸载】并在弹窗中确认。

危险操作:删除数据库和卸载 MySQL 都不可逆,请务必确认第一步的备份已完成、下载到本地。
第三步:安装目标 MySQL 版本
在【软件商店】搜索 MySQL,选择目标版本(如 MySQL 8.0),再根据需要选【极速安装】或【编译安装】,等待安装完成。

第四步:重建数据库用户并导入备份
装好新版 MySQL 后,按第一步记录的信息恢复数据:
- 在【数据库】页面点【添加数据库】,输入数据库名、用户名、密码,与之前记录的信息完全一致,逐个重建所有库;
- (可选)点【root密码】,输入之前记录的 root 密码改回原样;
- 点每个数据库的【导入】按钮,选择对应的备份文件(能直接看到就选它,看不到就先上传备份文件),等待导入完成。
验证版本并测试网站
导入完成后,从三个层面确认切换成功:
- 面板检查:进【软件商店】确认新版 MySQL 正在运行;
- 命令行验证(可选):执行
mysql -V看版本号; - 连接测试:用 phpMyAdmin 连接,确认所有数据库都能正常访问。
最后逐个测试用到数据库的网站:首页是否正常显示、用户能不能登录、数据读写和搜索、表单提交是否正常。
MySQL 5.7 升 8.0 的两个坑:字符集和认证方式
如果是从 5.7 升到 8.0,有两个变化最容易让网站出问题:
- 字符集:MySQL 8.0 默认字符集是
utf8mb4,旧版本可能用utf8,需要检查兼容性; - 认证方式:MySQL 8.0 默认使用
caching_sha2_password认证,部分老应用连不上时需要调整。可参考下方语句把指定用户改回旧认证方式:
ALTER USER 'username'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';
5.6 升 5.7 通常兼容性良好、较少出问题;反过来 8.0 降级回 5.7 则不建议,可能因为新版本的表结构和数据类型旧版不识别而丢数据。
网站连不上数据库怎么办
切换后如果网站报数据库连接错误,按顺序排查三处:
- 数据库用户是否按原记录重建正确;
- 若是 MySQL 8.0,是否因认证方式不兼容(用上面的
ALTER USER语句改认证); - 网站配置文件里的库名、用户名、密码是否和重建的一致。
出问题怎么回滚
切换过程中出现严重问题,两条回滚路径:
- 快照回滚:登录云服务器控制台,选择切换前创建的快照执行回滚,等系统恢复到切换前状态;
- 手动回滚:卸载新版 MySQL,重新装回原版本,再从本地备份恢复数据库,验证网站功能正常。
一句话总结
宝塔面板切换 MySQL 版本的核心是「先备份、再动手」:记录数据库账号和 root 密码 → 备份每个库并下载到本地 → 删除数据库、卸载旧版 → 安装目标版本 → 重建用户导入备份 → 验证。5.7 升 8.0 额外注意认证方式(caching_sha2_password)和字符集(utf8mb4)两处变化。
生产环境切换前,建议先在测试环境完整走一遍流程;遇到复杂问题寻求专业技术支持。
信息来源
本文步骤与说明以宝塔官方文档为准:《宝塔面板如何切换 MySQL 版本》。
常见问题
宝塔面板怎么切换 MySQL 版本?
按「备份 → 卸载旧版 → 装新版 → 导入」四步走:先在【数据库】页记录每个库的库名、用户名、密码和 root 密码,逐个备份数据库并下载到本地;再删除所有数据库、在【软件商店】卸载旧版 MySQL;接着搜索 MySQL 选目标版本(如 8.0)安装;最后按记录重建数据库用户并导入备份,用 phpMyAdmin 和网站功能验证。
切换 MySQL 版本会丢数据吗?
会。切换版本要先卸载旧版 MySQL,已有数据库不会自动保留,所以操作前必须把每个数据库备份下来并下载到本地,同时在云厂商控制台创建服务器快照或镜像。跳过备份直接卸载,数据将无法恢复。
MySQL 5.7 升级到 8.0 要注意什么?
注意两点:一是认证方式,8.0 默认用 caching_sha2_password,部分老应用连不上时需改成 mysql_native_password;二是字符集,8.0 默认 utf8mb4,旧库若是 utf8 需检查兼容性。5.6 升 5.7 通常兼容性良好,较少出问题。
切换后网站报数据库连接错误怎么办?
先查数据库用户是否按原记录重建正确,再确认网站配置文件里的库名、用户名、密码一致。若用的是 MySQL 8.0,可能是认证方式不兼容,可用 SQL 语句 ALTER USER 把该用户改回 mysql_native_password 认证。
可以从 MySQL 8.0 降级回 5.7 吗?
不建议降级。官方提示 8.0 降级到 5.7 可能导致数据丢失,因为新版本的部分表结构和数据类型旧版本不识别。确需回退时,走快照回滚(云厂商控制台恢复快照)比手动降级更安全。