phpMyAdmin 连不上 MySQL 8.0 是因为其默认使用 caching_sha2_password 认证插件，而旧版 phpMyAdmin 不支持该插件；必须通过 --default-authentication-plugin=mysql_native_password 启动 MySQL 或为用户显式执行 ALTER USER ... IDENTIFIED WITH mysql_native_password 并 FLUSH PRIVILEGES 才能解决。
MySQL 8.0 默认禁用 mysql_native_password 认证插件，phpMyAdmin 无法直连 —— 必须显式配置 --default-authentication-plugin=mysql_native_password 或在环境变量中指定用户密码组合，否则登录时会报错 Authentication plugin 'caching_sha2_password' cannot be loaded。
为什么 phpMyAdmin 连不上 MySQL 8.0？
这是最常卡住的点：MySQL 8.0+ 默认使用 caching_sha2_password 插件，而旧版 phpMyAdmin（包括 latest 标签下的多数镜像）不原生支持该认证方式。容器间通过服务名通信时，PMA_USER + PMA_PASSWORD 必须对应一个已存在且认证插件兼容的账号。
- 仅设
MYSQL_ROOT_PASSWORD不够 —— root 用户仍走默认插件 -
PMA_ARBITRARY=1是绕过方案，但需手动输 host:port，失去 Docker 内网自动发现优势 - 正确解法是让 MySQL 启动时强制使用兼容插件，或创建专用用户并指定插件
command 和 environment 怎么配合才生效？
MySQL 容器的 command 会覆盖镜像默认启动命令，必须放在 environment 之后解析；而 environment 中的 MYSQL_USER/MYSQL_PASSWORD 只在数据库首次初始化时创建用户，不会修改 root 的认证方式。
- 必须加
command: --default-authentication-plugin=mysql_native_password（注意双横线） -
MYSQL_USER和MYSQL_PASSWORD创建的普通用户，默认也走新插件，除非你额外执行 SQL 修改其 plugin 字段 - 若只用 root 登录，
PMA_USER: root+PMA_PASSWORD必须与MYSQL_ROOT_PASSWORD一致，且command已启用兼容插件
网络与依赖怎么写才可靠？
Docker Compose 默认为每个 services 块创建隐式网络，但 depends_on 仅控制启动顺序，不保证 MySQL 已 ready。phpMyAdmin 启动时若 MySQL 还没完成初始化，会反复重试失败甚至退出。
立即学习“PHP免费学习笔记（深入）”；
- 用
healthcheck替代裸depends_on：MySQL 服务里加healthcheck检查mysqladmin ping - phpMyAdmin 的
depends_on必须带condition: service_healthy，否则可能抢在 MySQL 就绪前启动 -
PMA_HOST填服务名（如mysql），不是localhost或 IP —— 后者在容器内指向自己，不是数据库容器
端口、卷、环境变量哪些必须显式配置？
最小可用组合其实很轻量，但漏掉任意一项都可能导致连接失败或数据丢失。
- MySQL 必须挂载
volumes：如./mysql-data:/var/lib/mysql，否则容器删掉数据就没了 - phpMyAdmin 的
ports可自定义（如13306:80），但宿主机端口不能被占用；MySQL 的3306:3306可省略（仅本地访问 phpMyAdmin 时），但调试或外部客户端连时需要 -
PMA_PORT默认是3306，可不写；PMA_HOST必须写，值为 MySQL 服务名 - 敏感信息（密码）建议用
.env文件管理，避免硬编码在 YAML 里
真正容易被忽略的是 healthcheck 的 timeout 和 retries 设置过短，MySQL 初始化可能耗时 10–20 秒（尤其首次启动+数据卷为空），而默认 retries: 3 配合 interval: 30s 才稳妥。不调这个，phpMyAdmin 很可能永远起不来。
