如何处理PHP环境中的MySQL 8.0密码插件兼容性_切换caching_sha2

PHP连不上MySQL 8.0首要检查mysql.user表中目标用户的plugin列是否为caching_sha2_password；若是，需用ALTER USER 'user'@'host' IDENTIFIED WITH mysql_native_password BY 'pwd'显式切换插件并FLUSH PRIVILEGES，且PHP驱动须为mysqlnd 5.0.12+（对应PHP 7.4+）才原生支持新认证协议。

如何处理php环境中的mysql 8.0密码插件兼容性_切换caching_sha2_password

PHP 连不上 MySQL 8.0？先查 `plugin` 列是不是 `caching_sha2_password`

很多 PHP 应用升级 MySQL 到 8.0 后突然报错，比如 mysqli_connect(): (HY000/2054): The server requested authentication method unknown to the client，或者 PDO 报 Authentication plugin 'caching_sha2_password' cannot be loaded。这不是密码错了，也不是网络不通，而是握手阶段就失败了——PHP 客户端压根不认识这个新插件。

关键动作是登录 MySQL（用宝塔终端、mysql -u root -p 或跳板机），执行：

SELECT user, host, plugin FROM mysql.user WHERE user = 'your_php_user';

如果 plugin 列显示 caching_sha2_password，那就对上了。注意：哪怕你刚重设过密码（SET PASSWORD），只要没显式换插件，它还是用原来的认证方式。

ALTER USER 必须带 `IDENTIFIED WITH`，不能只写 `IDENTIFIED BY`

这是最容易踩的坑。下面这两条命令效果完全不同：

ALTER USER 'app'@'localhost' IDENTIFIED BY '123';
→ 只改密码哈希值，插件保持不变（仍是 caching_sha2_password）
ALTER USER 'app'@'localhost' IDENTIFIED WITH mysql_native_password BY '123';
→ 显式切换认证插件，老版 PHP 就能连了

操作时注意几点：

必须用已有权限的账号（如 root）登录后执行
如果用户是 'app'@'%'，host 部分要严格匹配，别漏掉 %
执行完立刻生效，无需重启 MySQL
记得跟一句 FLUSH PRIVILEGES; 确保权限表刷新

PHP 驱动版本太低？`mysqlnd` 不支持也白搭

即使你把用户插件切成了 mysql_native_password，PHP 仍可能连不上——根源在底层驱动。

PHP 7.2 及更早版本自带的 mysqlnd 驱动不实现 caching_sha2_password 握手流程，也不处理 RSA 公钥交换
即使你强制用了新插件，它连“握手协议都解析不了”，直接断连

验证方法：在 PHP 中运行 var_dump(mysqli_get_client_info());，看输出是否含 mysqlnd 及其版本号。低于 mysqlnd 5.0.12（对应 PHP 7.4+）基本都不可靠。

临时解法只有两个：

kashen-mysql DDLtoExcel

解析 MySQL 8.0 的 DDL 脚本，并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景，导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理，每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。

下载

把用户插件切回 mysql_native_password（上一节已说）
或升级 PHP 至 7.4+ 并确认 mysqlnd 已启用（不是 libmysql）

云环境（如宝塔）里常默认装旧版 PHP，这点比插件切换更隐蔽。

my.cnf 里改 `default_authentication_plugin` 只影响新用户

有人看到文档说“加一行 default_authentication_plugin=mysql_native_password 就行”，于是去 /www/server/mysql/etc/my.cnf（宝塔路径）或 /etc/mysql/mysql.conf.d/mysqld.cnf 修改，然后重启 MySQL——结果 PHP 还是连不上。

原因很简单：这个配置项只决定后续 CREATE USER 时的默认插件，对已存在的用户完全无效。你数据库里所有老用户（包括 root、app）依然用原来的 caching_sha2_password。

所以正确顺序是：