为什么phpMyAdmin管理多台MySQL 8.0时会出现连接握手失败？-phpMyAdmin-PHP中文网

phpMyAdmin连接MySQL 8.0握手失败的主因是PHP mysqlnd驱动不支持caching_sha2_password认证插件，导致TCP连接后握手阶段直接断开；需检查各实例用户plugin字段并针对性修复。

为什么phpmyadmin管理多台mysql 8.0时会出现连接握手失败？

因为 phpMyAdmin 用的 PHP mysqlnd 驱动默认不支持 MySQL 8.0 的 caching_sha2_password 插件，而你给不同实例配置的用户可能用了不同认证方式，导致部分连接成功、部分握手失败。

phpMyAdmin 连接 MySQL 8.0 时卡在 handshake 阶段的真实原因

不是密码错，也不是网络不通——错误发生在 TCP 连接建立之后、密码校验之前。MySQL 8.0 启动时默认用 caching_sha2_password 作为 default_authentication_plugin，服务端在握手初期就声明“我只认这种协议”，而旧版 PHP（尤其是 PHP 7.2 之前或未启用 mysqlnd 扩展更新的版本）压根不认识这个插件名，直接断开连接，抛出类似 Client does not support authentication protocol requested by server 或 phpMyAdmin 里静默的 #2054 错误。

多实例场景下更易暴露问题：比如 A 实例是全新初始化的 8.0，默认所有用户都用 caching_sha2_password；B 实例是从 5.7 升级上来的，root 用户仍保留 mysql_native_password，但你新建的监控账号却继承了新默认；C 实例被手动改过全局插件，但某个用户又被单独 ALTER USER ... IDENTIFIED WITH mysql_native_password 覆盖过……结果就是 phpMyAdmin 对 A 连不上、对 B 和 C 能连，让人误以为是配置写错了。

检查每个 MySQL 实例当前用户的认证插件

别猜，直接查。登录每个 MySQL 实例后执行：

SELECT User, Host, plugin FROM mysql.user WHERE User NOT IN ('mysql.infoschema', 'mysql.session', 'mysql.sys');

重点关注你 phpMyAdmin 配置中实际使用的账号（比如 $cfg['Servers'][$i]['user'] 值），确认它的 plugin 字段是 caching_sha2_password 还是 mysql_native_password。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

如果全是 mysql_native_password，那问题不在认证插件，要查防火墙、bind_address 或账号 host 匹配问题
如果混着两种插件，说明你管理的实例状态不一致，必须统一策略
如果全是 caching_sha2_password，但 phpMyAdmin 仍连不上，说明 PHP 环境不支持——此时看 PHP 版本和 mysqlnd 编译选项

临时修复：为特定账号切换认证插件（推荐单点操作）

比起改全局 default_authentication_plugin（影响所有新建用户），更安全的做法是只改 phpMyAdmin 用的账号：

确保你有管理员权限，用 mysql -u root -p 登录对应实例
执行：ALTER USER 'your_phpmyadmin_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
立即生效：FLUSH PRIVILEGES;
注意：host 必须严格匹配，'user'@'127.0.0.1' 和 'user'@'localhost' 是两个账号，别漏掉

这条命令不会动其他用户，也不会影响后续升级兼容性，适合混搭环境快速收口。

长期方案：PHP 层面适配 caching_sha2_password

硬切回 mysql_native_password 是权宜之计，安全强度下降，且未来 MySQL 可能弃用。真正解法是让 PHP 支持新插件：

PHP ≥ 7.4 且编译时启用了 --with-mysqlnd（现代发行版基本默认开启）才原生支持 caching_sha2_password
若用 PDO，连接 DSN 中需显式加 &allowPublicKeyRetrieval=true（仅调试用，生产慎开）
若用 mysqli，确保 mysqli.options 中设置了 MYSQLI_OPT_SSL_MODE = MYSQLI_SSL_MODE_DISABLED（避免 SSL 强制干扰握手）
phpMyAdmin 5.0+ 已内置适配逻辑，但前提是底层 PHP 满足条件；低于 5.0 的版本建议升级

多实例管理时最容易被忽略的是：你改了一个实例的用户插件，但忘了同步修改 phpMyAdmin 的 config.inc.php 里对应 $i 的 auth_type 和密码字段——尤其是当多个实例共用同一份配置文件、靠注释开关切换时，极易漏掉某一段。