怎么在Docker Compose中编排phpMyAdmin_容器互联配置-phpMyAdmin-PHP中文网

根本原因是MySQL容器未创建root@%账号，phpMyAdmin远程连接被拒；需设MYSQL_ROOT_HOST:"%"或改用普通用户，PMA_HOST必须填MySQL容器名，且需配置PMA_ARBITRARY:"1"、字符集统一为utf8mb4，并通过healthcheck确保MySQL就绪。

phpMyAdmin 连接 MySQL 容器时显示 “Access denied for user”

根本原因不是密码错了，而是 phpmyadmin 默认用 root 用户连 mysql，但 docker 官方 mysql 镜像在 mysql_root_password 之外，**不自动创建 root@% 这个远程可登录账号**——它只建了 root@localhost，而 phpmyadmin 容器和 mysql 容器是不同网络节点，属于远程连接。

实操建议：

在 mysql 服务里显式设置 MYSQL_ROOT_HOST: "%"（Docker Hub 官方镜像 v8.0.23+ 支持）
或改用普通用户：给 mysql 加 MYSQL_USER 和 MYSQL_PASSWORD，再让 phpMyAdmin 用这个用户连
不要依赖 root + 空密码，新版 MySQL 默认禁用空密码登录

docker-compose.yml 中 phpMyAdmin 的 PMA_HOST 必须写容器名

PMA_HOST 不是填 127.0.0.1 或 localhost，那是 phpMyAdmin 容器自己的回环地址，连不到隔壁 MySQL 容器。Docker Compose 自动为每个 service 创建 DNS 记录，名字就是 service 名。

实操建议：

确保 mysql 服务的 service 名是 mysql（不是 db 或 database），否则 PMA_HOST 得同步改成那个名字
PMA_PORT 一般不用设，默认走 3306；如果 MySQL 改了端口映射（比如 "3307:3306"），这里才需配 PMA_PORT: "3306"
别漏掉 PMA_ARBITRARY: "1" —— 否则 phpMyAdmin 界面右上角不会显示“服务器选择”下拉框，无法手动切不同 MySQL 实例

PHP 与 MySQL 字符集不一致导致中文乱码

即使 MySQL 容器设置了 utf8mb4，phpMyAdmin 容器默认仍可能用 latin1 建立连接，结果表数据显示 ????，导出 SQL 也带乱码。

实操建议：

MySQL 侧加环境变量：MYSQL_COLLATION: "utf8mb4_unicode_ci" 和 MYSQL_CHARACTER_SET: "utf8mb4"
phpMyAdmin 侧加配置挂载：用 volumes 把自定义 config.inc.php 挂进 /etc/phpmyadmin/，里面加 $cfg['Servers'][$i]['charset'] = 'utf8mb4';
避免只改 MySQL 的 my.cnf：phpMyAdmin 的 PHP 连接层不读那个文件，得从应用层控制

phpMyAdmin 容器启动后白屏或 500 错误

常见于没配好依赖顺序或共享网络，比如 MySQL 还没 ready，phpMyAdmin 就急着连，PHP 报错后直接崩，Nginx 返回空白页。

实操建议：

用 depends_on 只控制启动顺序，**不保证服务就绪**；必须配合健康检查：healthcheck + condition: service_healthy
phpMyAdmin 容器里别装 curl 或 ping 去轮询——它没这些工具；健康检查得靠 mysqladmin ping 或自定义脚本
如果用的是 phpmyadmin/phpmyadmin 镜像（非官方），注意它默认监听 80，但有些 Nginx 反代会强制 HTTPS，导致 500；先确认是否能直连容器 IP:80