怎样解决phpMyAdmin在MySQL 8.4 LTS版本中的兼容性难题？-phpMyAdmin-PHP中文网

php连接mysql 8.4失败主因是caching_sha2_password认证插件不兼容，需将phpmyadmin专用账号（如pma）改用mysql_native_password认证，并配置host为127.0.0.1、显式指定端口，同时确保controluser为8.4单独创建且授权完整，php必须使用mysqlnd驱动并启用mysqli/pdo_mysql扩展。

phpmyadmin 连不上 mysql 8.4：认证插件不匹配是头号原因

mysql 8.4 默认启用 caching_sha2_password 插件，而多数 phpmyadmin 版本（尤其 5.2.x 及更早）仍依赖 mysql_native_password 协议握手。连接失败时典型报错：pdoexception: sqlstate[hy000] [2054] the server requested authentication method unknown to the client。

临时解决方法是降级用户认证方式，但仅限专用账户：

用 root 登录 MySQL 8.4：mysql -u root -p
执行：ALTER USER 'pma'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_secure_pass';
立即生效，无需重启服务；不要对应用主库账号执行此操作

phpMyAdmin 配置里必须显式指定 host 和 port

MySQL 8.4 不再默认接受 localhost 作为 socket 连接别名——它会优先走命名管道或 Unix socket，而 phpEnv 或独立部署的 8.4 实例往往监听 TCP 端口。若配置中只写 $cfg['Servers'][$i]['host'] = 'localhost';，很可能连错实例或直接超时。

正确做法是强制走 TCP：

把 host 改为 127.0.0.1（而非 localhost）
明确指定端口：$cfg['Servers'][$i]['port'] = '3307';（假设你避开了 phpEnv 默认的 3306）
确认该端口在 Windows 防火墙或安全组中已放行

controluser 必须为 MySQL 8.4 单独创建并授权

phpMyAdmin 的高级功能（如关系视图、用户管理）依赖一个特权账户 controluser。这个账号不能复用 MySQL 5.7 或 8.0 的同名账号——8.4 的权限模型和系统表结构已有变化，复用会导致 #1045 Cannot log in to the MySQL server。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

创建步骤（需在 MySQL 8.4 实例内执行）：

CREATE USER 'pma84'@'localhost' IDENTIFIED WITH mysql_native_password BY 'strong_pass';
GRANT SELECT, INSERT, UPDATE, DELETE ON `phpmyadmin`.* TO 'pma84'@'localhost';
GRANT SELECT ON `mysql`.`columns_priv` TO 'pma84'@'localhost';（8.4 要求额外权限）
在 config.inc.php 中指向它：$cfg['Servers'][$i]['controluser'] = 'pma84';

PHP 扩展与驱动版本必须匹配 mysqlnd

phpMyAdmin 底层靠 mysqli 或 PDO_mysql 扩展通信，而这些扩展能否正确解析 8.4 的新协议、错误码、字段类型，取决于所用的客户端库是否为 mysqlnd（而非 libmysqlclient）。旧版 PHP 编译包可能仍链接后者，导致认证失败或字段元信息读取异常。

验证和修复方法：

运行 php -i | grep "Client API library version"，输出含 mysqlnd 才合规
若显示 libmysqlclient，需重编译 PHP 或换用官方预编译包（如 phpEnv v3.2+ 或 XAMPP 8.4+）
确保 php.ini 中未注释：extension=mysqli 和 extension=pdo_mysql

最易被忽略的是 controluser 权限细节和 mysqlnd 驱动绑定——这两项出问题，即使认证插件改了、端口写对了，phpMyAdmin 仍会在“用户管理”或“结构”页静默失败，错误日志里却只有一行 mysqli_real_connect(): (HY000/1045): Access denied，根本看不出是权限粒度或驱动兼容性问题。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！