Docker中MySQL容器无法通过本地Workbench连接的问题求助

你遇到的连接失败问题，常见原因及解决方法如下：

1. 容器未正常运行 #

先检查MySQL容器是否处于运行状态：

docker ps

如果列表里没有名为mysql的容器，或者状态不是Up，先启动容器：

docker start mysql

如果容器启动失败，查看日志排查错误：

docker logs mysql

2. Root用户默认限制本地访问 #

官方MySQL镜像默认配置下，root用户仅允许容器内部localhost访问，外部客户端无法直接连接。解决方法有两种：

方法一：启动容器时直接配置允许远程访问 #

修改启动命令，添加初始化参数，让root允许所有主机访问并兼容旧加密方式：

docker run --name mysql -p 3306:3306 -e MYSQL_ROOT_PASSWORD=root -d mysql --default-authentication-plugin=mysql_native_password --bind-address=0.0.0.0

方法二：进入容器修改用户权限 #

1. 进入容器终端：

docker exec -it mysql bash

2. 登录MySQL：

mysql -uroot -proot

3. 修改root用户的访问权限与加密方式：

ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root';
FLUSH PRIVILEGES;

（%表示允许所有远程主机访问，也可以指定具体IP）

3. 主机3306端口被占用 #

如果主机本地安装了MySQL服务，或者其他程序占用了3306端口，容器的端口映射会失效。检查端口占用：

• Windows：

netstat -ano | findstr :3306

• Linux/Mac：

lsof -i :3306

如果端口被占用，启动容器时更换主机端口，比如用3307映射容器的3306：

docker run --name mysql -p 3307:3306 -e MYSQL_ROOT_PASSWORD=root -d mysql --default-authentication-plugin=mysql_native_password

然后Workbench连接时，端口填写3307。

4. MySQL 8.0+加密方式兼容性问题 #

MySQL 8.0及以上版本默认使用caching_sha2_password加密算法，部分旧版本Workbench可能不支持。解决方法参考上述步骤中添加--default-authentication-plugin=mysql_native_password参数，或进入容器修改root用户的加密方式。

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