宝塔升级MySQL8.0错误解决办法

宝塔升级MySQL 8.0后频繁出现“Plugin caching_sha2_password could not be loaded”连接报错，本质是新版默认认证插件与旧版PHP、Navicat及宝塔自身管理界面不兼容所致——问题不在密码错误，而在于客户端根本不认识新插件；只需通过ALTER USER显式切换root用户（及必要时远程用户）的认证方式为mysql_native_password并执行FLUSH PRIVILEGES即可秒级恢复连接，无需重启服务或重装数据库；同时提醒备份时务必使用--set-gtid-purged=OFF参数规避GTID导入异常，避开宝塔界面一键备份的潜在陷阱，兼顾效率、安全与稳定性。

MySQL 8.0 升级后连接报错 Plugin caching_sha2_password could not be loaded

这是宝塔升级 MySQL 8.0 后最典型的兼容性问题：旧客户端（如 PHP 的 mysqlnd、某些 Navicat 版本、甚至宝塔自身数据库管理页）不支持 MySQL 8.0 默认的 caching_sha2_password 认证插件，直接拒绝连接。

根本原因不是密码错了，而是服务端要求用新插件鉴权，而客户端压根不认识它。别急着重装或删库，先验证是否是这个原因：

• 登录宝塔终端，执行 mysql -u root -p，如果能进，说明本地命令行客户端已兼容；若报错该插件加载失败，则大概率是远程/PHP 连接出问题
• 检查当前用户认证方式：SELECT user,host,plugin FROM mysql.user WHERE user='root'; —— 若 plugin 列显示 caching_sha2_password，就对上了

临时绕过：把 root 用户切回 mysql_native_password 插件

这不是降级安全，而是快速恢复业务的务实做法。MySQL 8.0 仍完全支持 mysql_native_password，只是不再设为默认。

操作前确保你已用 root 登录成功（可通过宝塔终端或跳板机）：

• 执行 ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY '你的当前密码';
• 如果要同时允许远程 root 连接（不推荐生产环境），再加一行：ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY '你的当前密码';
• 刷新权限：FLUSH PRIVILEGES;
• 验证修改结果：SELECT user,host,plugin FROM mysql.user WHERE user='root'; —— 确认 plugin 已变为 mysql_native_password

改完立刻生效，无需重启 MySQL。PHP、Django、旧版客户端基本都能连上了。

备份数据时要注意 mysqldump 的 --set-gtid-purged 参数

升级后若启用了 GTID（宝塔 8.0+ 默认开启），直接用老命令导出可能报错 GTID state cannot be changed 或导致还原失败。

安全导出建议用：

mysqldump --all-databases --single-transaction --routines --triggers --set-gtid-purged=OFF -u root -p > full_backup.sql

• --set-gtid-purged=OFF 是关键，避免导出文件里写死 GTID 位置，否则在非 GTID 环境或不同主从拓扑下无法导入
• --single-transaction 保证一致性，适合 InnoDB 表；若含 MyISAM，需改用 --lock-all-tables
• 别用宝塔界面一键备份——它默认不加 --set-gtid-purged=OFF，导出的 SQL 在还原时容易卡住

为什么不能只改密码而不改插件？

很多人试过 ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';，发现还是连不上。因为这条命令在 MySQL 8.0+ 中**不会改变 plugin 字段**，只会重置密码，认证方式仍为 caching_sha2_password。

必须显式指定 WITH mysql_native_password，否则徒劳。这也是最容易被忽略的一行 —— 看似改了密码，其实认证协议没变，客户端照样报插件加载失败。

真要长期用 caching_sha2_password，得同步升级所有客户端：PHP 至 7.4+ 并启用 mysqlnd，Navicat 至 12.1+，且连接字符串里加上 ?serverVersion=8.0 显式声明版本。但对多数宝塔用户，切回 mysql_native_password 更省事也足够安全。

好了，本文到此结束，带大家了解了《宝塔升级MySQL8.0错误解决办法》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！