为什么phpMyAdmin无法连接Docker容器中的Laravel数据库？-phpMyAdmin-PHP中文网

phpmyadmin在宿主机运行时不能填localhost，因其指向宿主机127.0.0.1而非docker内mysql；应填127.0.0.1（需端口映射）或容器名（需同自定义网络），并配对应用户权限如'root'@'127.0.0.1'。

phpmyadmin 连不上 docker 里的 mysql，不是 phpmyadmin 配置错了，而是它根本没连对容器网络——它在宿主机上跑，却试图用 localhost 去找数据库，而 docker 容器里的 mysql 并不监听宿主机的 localhost。

phpMyAdmin 的 `$cfg['Servers'][$i]['host']` 为什么不能填 `localhost`？

在宿主机上直接运行的 phpMyAdmin（比如宝塔面板、MAMP 自带的），localhost 指的是本机的 MySQL 进程；但当你用 Docker 启了 MySQL 容器后，它的服务只暴露在 Docker 网络内部。此时 localhost 对 phpMyAdmin 来说还是宿主机的 127.0.0.1，压根没走 Docker 网络，自然连不上。

正确做法是：把 $cfg['Servers'][$i]['host'] 改成数据库容器名（如 mysql 或 db），前提是 phpMyAdmin 也运行在同一个 Docker 网络里
如果 phpMyAdmin 是宿主机原生安装的（非容器），那就必须用 127.0.0.1 + 映射端口（如 3306），且确保 MySQL 容器的 ports 正确配置了 - "3306:3306"
别信“填 docker.host.internal 就行”——这仅在 Docker Desktop for Mac/Windows 有效，Linux 不支持，生产环境更不可靠

MySQL 容器用户权限为什么总被忽略？

即使 host 填对了、端口映射了、服务也 running，phpMyAdmin 还是报 #1045 Cannot log in to the MySQL server，大概率是权限问题。MySQL 认证看的是 'user'@'host' 这个完整组合，不是只看用户名。

如果你的 DB_HOST 是 127.0.0.1，那 MySQL 用户必须是 'root'@'127.0.0.1'，而不是只有 'root'@'localhost'
Docker 启动时用 MYSQL_ROOT_HOST=% 可临时放通所有 host（仅开发），但正式环境应明确授权：GRANT ALL ON *.* TO 'root'@'127.0.0.1' IDENTIFIED BY 'yourpass'; FLUSH PRIVILEGES;
检查命令：docker exec -it your-mysql-container mysql -uroot -pyourpass -e "SELECT User,Host FROM mysql.user;"

MySQL 8 的 `caching_sha2_password` 怎么让 phpMyAdmin 静默失败？

phpMyAdmin 用的是 PHP 的 mysqli 扩展，老版本（PHP #2054 The server requested authentication method unknown to the client。

btpanel phpsite 宝塔面板PHP网站

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

下载

最快验证：进 MySQL 容器执行 SELECT user, host, plugin FROM mysql.user WHERE user = 'root'; —— 如果 plugin 是 caching_sha2_password，就坐实了
临时修复（开发用）：ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'yourpass'; FLUSH PRIVILEGES;
长期方案：升级宿主机 PHP 到 7.4+，并确认 php -i | grep mysqlnd 输出包含 caching_sha2_password

怎么确认 phpMyAdmin 和 MySQL 容器真在同一个网络？

很多人改完配置就重试，其实连网络都没通。Docker 容器之间通信靠的是自建 bridge 网络，不是靠 IP 或端口映射。

运行 docker network ls，找到你的 compose 项目网络名（通常是 yourproject_default）
查两个容器是否都在该网络：docker inspect your-phpmyadmin-container | grep NetworkMode 和 docker inspect your-mysql-container | grep NetworkMode
如果 phpMyAdmin 是宿主机进程，它不在任何 Docker 网络里，只能走 127.0.0.1:3306 —— 此时必须确保 MySQL 容器启动时加了 bind-address = 0.0.0.0（默认已开），且 skip-networking 是 off

最常漏掉的其实是网络归属和用户 host 组合——它们不报具体错误，只让连接卡在「无法登录」，调试时容易绕远路去查密码或 phpMyAdmin 日志，而真正该看的是 MySQL 容器里的用户表和网络拓扑。