PMA_HOST必须填MySQL服务名（如db），而非127.0.0.1或localhost，因Docker Compose内置DNS仅解析服务名；同时需设MYSQL_ROOT_HOST:"%"、统一utf8mb4字符集，并通过healthcheck确保MySQL就绪后再启动phpMyAdmin。
能直接跑起来，但连不上 mysql 的 compose 配置，90% 是因为 pma_host 指错了、mysql_root_host 没设或字符集没对齐——不是镜像选错，也不是端口映射漏了。
为什么 PMA_HOST 必须填服务名，而不是 127.0.0.1 或 IP
Docker Compose 默认为每个 service 创建 DNS 记录，名字就是 service 名。phpMyAdmin 容器里执行 ping mysql 能通，靠的就是这个内置解析；填 127.0.0.1 是它自己回环，根本连不到隔壁容器。
-
PMA_HOST值必须和mysql服务的 service 名完全一致（比如你写的是db，那就得设PMA_HOST: db） - 别用
localhost或host.docker.internal——前者在容器内指向自身，后者在 Linux 主机上默认不启用 - 如果 MySQL 服务名是
database，那PMA_HOST就得同步改成database，不能硬编码成mysql
MySQL 容器必须显式允许 root 远程登录
官方 mysql 镜像（v8.0.23+）默认只建 root@localhost，而 phpMyAdmin 是从另一个容器发起连接，属于远程访问，会被拒绝。
- 加环境变量：
MYSQL_ROOT_HOST: "%"（注意是字符串"%"，不是%） - 或者更安全的做法：改用普通用户，加
MYSQL_USER和MYSQL_PASSWORD，再让 phpMyAdmin 用这个账号连 - 别依赖空密码或
MYSQL_ALLOW_EMPTY_PASSWORD: "yes"—— MySQL 8+ 默认禁用空密码登录
字符集不统一会导致中文显示 ????
即使 MySQL 容器设置了 utf8mb4，phpMyAdmin 默认仍可能用 latin1 建立连接，结果表数据乱码、导出 SQL 也带问号。
- MySQL 侧至少加两个环境变量：
MYSQL_CHARACTER_SET: "utf8mb4"和MYSQL_COLLATION: "utf8mb4_unicode_ci" - phpMyAdmin 侧不能只改 MySQL 的
my.cnf—— PHP 连接层不读那个文件；得挂载自定义配置，比如volumes: - ./config.inc.php:/etc/phpmyadmin/config.user.inc.php，并在里面加$cfg['Servers'][$i]['charset'] = 'utf8mb4'; - 别漏掉
PMA_ARBITRARY: "1"—— 否则界面右上角没有服务器选择下拉框，无法手动切实例
depends_on 不等于“就绪”，MySQL 启动慢必须加 healthcheck
depends_on 只控制启动顺序，不等 MySQL 真正监听 3306 端口。phpMyAdmin 启动太快，会因连接被拒报错，然后反复重启。
立即学习“PHP免费学习笔记（深入）”；
- 给 MySQL 加
healthcheck，例如：test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p$$MYSQL_ROOT_PASSWORD"]（注意$要双写） - phpMyAdmin 的
depends_on改成条件形式：depends_on: mysql: condition: service_healthy - MySQL 的
restart: always要配好，避免因初始化失败退出后整个栈卡住
真正麻烦的从来不是写几行 YAML，而是 MySQL 初始化阶段的权限创建时机、PHP 连接层的字符集协商逻辑、以及容器网络 DNS 解析的隐式依赖——这些点一旦漏掉一个，界面就只显示 “Access denied” 或一堆 ???，查日志也看不出 root 密码错在哪。
