Docker Compose环境中PhpMyAdmin与MySQL连接失败求助

针对你遇到的PhpMyAdmin提示“Can't connect to server”的问题，可从以下几个方向排查解决：

1. 解决MySQL启动慢导致的连接超时问题 #

PhpMyAdmin可能在MySQL容器完全就绪前就启动了，导致连接失败。可以通过健康检查+启动依赖确保PhpMyAdmin在MySQL服务可用后再启动：

修改docker-compose.yml中mysql和phpmyadmin的配置：

mysql:
    image: mysql
    container_name: mysql
    environment:
          MYSQL_ROOT_PASSWORD: '<mypassword>'
          MYSQL_DATABASE: baton
          MYSQL_USER: baton
          MYSQL_PASSWORD: '<mypassword>'
    ports:
          - "3306:3306"
    volumes:
          - ./database/mysql:/var/lib/mysql
    # 添加健康检查，确认MySQL服务就绪
    healthcheck:
          test: ["CMD", "mysqladmin", "ping", "-h", "localhost", "-u", "root", "-p<mypassword>"]
          interval: 10s
          timeout: 5s
          retries: 5

phpmyadmin:
    image: phpmyadmin/phpmyadmin
    container_name: pma
    # 依赖MySQL健康状态
    depends_on:
          mysql:
              condition: service_healthy
    environment:
          PMA_HOST: mysql
          PMA_PORT: 3306
          PMA_ARBITRARY: 1
    restart: always
    ports:
          - 8081:80

2. 解决MySQL 8.0+的认证插件兼容性问题 #

如果使用的是最新版MySQL镜像（默认8.0+），默认认证插件为caching_sha2_password，部分PhpMyAdmin版本可能不兼容。可以强制MySQL使用旧版认证插件：

修改mysql服务的环境变量：

mysql:
    image: mysql
    container_name: mysql
    environment:
          MYSQL_ROOT_PASSWORD: '<mypassword>'
          MYSQL_DATABASE: baton
          MYSQL_USER: baton
          MYSQL_PASSWORD: '<mypassword>'
          # 允许root远程连接
          MYSQL_ROOT_HOST: '%'
          # 强制使用旧版认证插件
          MYSQL_INITDB_ARGS: "--default-authentication-plugin=mysql_native_password"
    ports:
          - "3306:3306"
    volumes:
          - ./database/mysql:/var/lib/mysql

修改后需要删除本地./database/mysql目录（清空旧数据），再重新执行docker-compose up -d让初始化配置生效。

3. 排查网络连通性问题 #

Docker Compose默认会为所有服务创建同一网络，但也可显式定义网络确保连通：

在docker-compose.yml末尾添加网络配置，并给每个服务绑定该网络：

# 所有服务共用的网络
networks:
    app-network:
        driver: bridge

# 给每个服务添加networks字段，示例：
web:
    image: nginx:latest
    ports:
        - "8080:80"
    volumes:
        - ./src:/var/www/html
        - ./default.conf:/etc/nginx/conf.d/default.conf
    links:
        - php-fpm
    networks:
        - app-network

# php-fpm、mysql、phpmyadmin服务同样添加networks: - app-network

快速排查命令 #

• 查看MySQL容器状态：docker-compose ps mysql
• 查看MySQL日志找错误：docker-compose logs mysql
• 进入PhpMyAdmin容器测试连通性：docker exec -it pma ping mysql
• 在PhpMyAdmin容器内测试MySQL连接：docker exec -it pma mysql -h mysql -u root -p<mypassword>

内容的提问来源于stack exchange，提问作者Maddin