无法通过MySQL Workbench/PHPMyAdmin连接Docker内的MySQL容器

我来帮你一步步排查这个连接失败的问题，结合你给出的docker-compose.yml片段，先从配置完善和常见坑点入手：

1. 先补全并优化你的docker-compose.yml配置 #

你给出的phpmyadmin服务配置不完整，我帮你补充了必要的关联配置和细节，这样能避免很多容器间通信的问题：

version: '2.0'
services:
  db:
    image: mysql:8.0  # 建议指定具体版本，避免自动拉取最新版本带来的兼容性问题
    environment:
      - MYSQL_DATABASE=mysqltest
      - MYSQL_USER=user
      - MYSQL_PASSWORD=userpassword
      - MYSQL_ROOT_PASSWORD=rootpassword
      - MYSQL_DEFAULT_AUTH=mysql_native_password  # 解决8.0+版本的认证插件兼容问题
    ports:
      - "127.0.0.1:3306:3306"
    volumes:
      - mysql_data:/var/lib/mysql  # 挂载数据卷，防止容器重启丢失数据
    restart: unless-stopped

  phpmyadmin:
    image: phpmyadmin/phpmyadmin:latest
    environment:
      - PMA_HOST=db  # 必须和db服务名称一致，Docker内部通过服务名DNS解析
      - PMA_PORT=3306
      - PMA_USER=root
      - PMA_PASSWORD=rootpassword
    ports:
      - "8080:80"  # 本地访问端口设为8080，避免和其他服务冲突
    depends_on:
      - db  # 确保MySQL容器先启动再启动phpmyadmin
    restart: unless-stopped

volumes:
  mysql_data:

2. 逐个排查常见连接失败原因 #

（1）MySQL 8.0+的认证插件兼容问题 #

这是最常见的坑！MySQL 8.0+默认用caching_sha2_password认证插件，而一些旧版本的MySQL Workbench、PHPMyAdmin镜像可能不支持这个插件，直接导致连接失败。我上面的配置已经加了MYSQL_DEFAULT_AUTH=mysql_native_password来强制使用旧插件，如果你不想改配置，也可以升级MySQL Workbench到最新版本，或者进入MySQL容器手动修改用户的认证方式：

# 进入MySQL容器
docker-compose exec db mysql -uroot -prootpassword
# 修改user用户的认证方式
ALTER USER 'user'@'%' IDENTIFIED WITH mysql_native_password BY 'userpassword';
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'rootpassword';
FLUSH PRIVILEGES;

（2）连接地址和端口的坑 #

• MySQL Workbench：连接时主机地址一定要填127.0.0.1，不要填localhost——因为localhost在某些系统下会优先走socket连接，而Docker映射的是TCP端口，填127.0.0.1才能强制走TCP连接。端口填3306，用户名用root或者你创建的user，对应密码填写。
• PHPMyAdmin：访问地址是http://127.0.0.1:8080，登录时用root/rootpassword或者user/userpassword就行，注意内部的PMA_HOST必须是db，因为Docker容器间是通过服务名通信的。

（3）容器状态与日志排查 #

先确认两个容器都正常运行：

docker-compose ps

如果db容器状态不是Up，就看日志找原因：

docker-compose logs db

常见的问题比如密码太简单（MySQL 8.0+对密码复杂度有要求，比如不能全小写、不能太短），或者数据卷权限问题，日志里都会明确提示。

（4）端口占用或防火墙问题 #

检查本地3306端口有没有被其他程序占用：

# Windows系统
netstat -ano | findstr :3306
# Linux/macOS系统
lsof -i :3306

如果被占用，要么关掉占用的程序，要么把docker-compose里的端口映射改成3307:3306，然后MySQL Workbench连接时用3307端口就行。另外，确保本地防火墙没有拦截3306或8080端口。

（5）MySQL用户权限问题 #

有时候创建的用户没有远程访问权限（哪怕是Docker内部的访问），可以进入容器给用户授权：

docker-compose exec db mysql -uroot -prootpassword
# 给user用户授权访问mysqltest数据库
GRANT ALL PRIVILEGES ON mysqltest.* TO 'user'@'%';
# 给root用户授权所有数据库的访问权限
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%';
FLUSH PRIVILEGES;

3. 重新部署容器 #

修改完配置后，彻底重启容器：

docker-compose down
docker-compose up -d

等容器启动完成后，再尝试连接MySQL Workbench和PHPMyAdmin，应该就能成功了。

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