如何修复phpMyAdmin无法连接导致表结构加载失败的常见错误？-phpMyAdmin-PHP中文网

phpmyadmin无法连接mysql 8.0的主因是caching_sha2_password认证插件不兼容，导致mysqli_real_connect()静默失败；临时方案为执行alter user 'pma_user'@'localhost' identified with mysql_native_password by 'password'并flush privileges，长期方案需升级phpmyadmin至5.1.0+且php 7.4+支持该插件。

phpmyadmin 表结构加载失败，90% 是连接根本没建立成功——不是界面卡住，而是底层 mysqli_real_connect() 已静默失败，后续所有操作（包括显示表结构、用户列表、sql 执行）都只是“假死”状态。

确认是不是真的连不上：看错误日志和登录页行为

别急着改配置。先判断问题层级：

打开 phpMyAdmin 登录页，输入账号密码后直接跳转到错误页，提示 mysqli_real_connect(): (HY000/2002) 或 The server requested authentication method unknown to the client → 这是连接层失败，表结构加载失败只是结果，不是原因
能成功登录，但点进任意数据库后，左侧表列表空白、右侧显示 #1146 - Table 'mysql.user' doesn't exist 或字段错乱 → 这才是表结构或系统表层面的问题，需单独处理
登录页就报 Cannot start session without errors 或白屏 → 是 PHP 会话或权限问题，和 MySQL 连接无关

MySQL 8.0+ 下 `caching_sha2_password` 认证不兼容

这是当前最常被忽略的连接中断根源，尤其在 Docker 或新装环境里。phpMyAdmin 启动时尝试用 root 连接，但 MySQL 8.0 默认给 root 分配了 caching_sha2_password 插件，而旧版 phpMyAdmin（mysqlnd 驱动根本不认识它。

验证方式：进 MySQL 命令行执行 SELECT user, host, plugin FROM mysql.user WHERE user = 'root';，若 plugin 列显示 caching_sha2_password，就是它
临时修复（开发/测试环境）：ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password'; FLUSH PRIVILEGES;
生产环境应升级 phpMyAdmin ≥5.1.0 并确保 PHP 使用 7.4+ 且 mysqlnd 编译支持该插件，不能只看 phpMyAdmin 版本号，得看运行时 phpinfo() 中 mysqlnd 的版本和编译参数

config.inc.php 里 `$cfg['Servers'][$i]['host']` 和 `port` 配置错位

常见于 XAMPP、宝塔或手动迁移后：MySQL 端口被改成 3307，但 config.inc.php 里仍为空或写死 3306；或者 host 写成 localhost 导致走 socket 连接，而 MySQL 实际禁用了 socket 或路径不对。

btpanel phpsite 宝塔面板PHP网站

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

下载

$cfg['Servers'][$i]['host'] 推荐显式设为 '127.0.0.1'（强制 TCP），避免 Unix socket 路径不一致引发的 No such file or directory
$cfg['Servers'][$i]['port'] 必须与 my.cnf 中 port= 值完全一致；若 MySQL 配置了 skip-networking，则必须关掉才能用 TCP 连接
宝塔环境下，还要确认 /www/server/data/mysqld.sock 文件存在且权限为 mysql:mysql，否则 localhost 会因找不到 socket 而失败

容器化部署中服务名解析失败（Docker Compose 场景）

错误信息如 getaddrinfo failed: Temporary failure in name resolution，本质是 phpMyAdmin 容器压根不知道 mysqldb 是谁——它没被告知主机名，也没启用动态发现。

必须在 phpMyAdmin 的 environment 中明确设置：PMA_HOST=mysqldb（固定连接）或 PMA_ARBITRARY=1（手动输入），二者不可同时省略
MYSQL_ROOT_PASSWORD 对 phpMyAdmin 完全无效，它只被 MySQL 容器读取；phpMyAdmin 连接用的密码必须通过 PMA_PASSWORD 单独传入
两个服务必须共用同一自定义网络（如 mysql-net），默认 bridge 网络无法跨服务解析名称

真正棘手的不是报错本身，而是错误掩盖了真实断点：比如你看到表结构加载失败，就去查 mysql.user 表，却没意识到 phpMyAdmin 根本没连上 MySQL——所有后续行为都是无意义的。先抓底层连接日志（PHP 错误日志、MySQL error.log、容器 docker logs），再动手改配置。