Docker：本地MySQL容器无法连接的问题排查求助

核心问题排查 #

1. MySQL用户权限限制 #

你设置MYSQL_USER=root，但MySQL默认的root用户仅允许从容器内部的localhost登录，本地客户端通过宿主机IP连接时会被拒绝。

解决操作：
进入容器执行授权命令：

docker exec -it mysql_container bash
mysql -uroot -proot

执行SQL开放远程访问权限：

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

2. MacOS端口冲突问题 #

检查本地3306端口是否被其他进程占用：

lsof -i :3306

若有占用，要么停止对应进程，要么修改.env中的MYSQL_PORT为其他端口（如3307），再重启容器。

3. Dockerfile配置冗余与错误 #

• 官方MySQL镜像已自动处理目录权限，RUN chown -R mysql:root /var/lib/mysql属于冗余操作，可能引发权限异常。
• 环境变量赋值时的空格会导致变量值异常，ENV MYSQL_DATABASE = $MYSQL_DATABASE应改为ENV MYSQL_DATABASE=$MYSQL_DATABASE（其他环境变量同理）。

优化后的配置建议 #

简化Dockerfile #

直接使用官方MySQL镜像，无需自定义Dockerfile（官方镜像已自动完成数据库初始化、环境变量读取等逻辑）。

优化docker-compose.yml #

version: '3.9'
services:
  mysql:
    container_name: mysql_container
    image: mysql:8.0 # 指定明确的8+版本，避免latest自动更新带来的兼容性问题
    command: mysqld --default-authentication-plugin=mysql_native_password
    environment:
      MYSQL_DATABASE: ${MYSQL_DATABASE}
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
    ports:
      - "${MYSQL_PORT}:3306"
    volumes:
      - mysql_data:/var/lib/mysql # 挂载数据卷，防止容器删除后数据丢失
    networks:
      default:
        aliases:
          - mysql_alias

volumes:
  mysql_data:

修正.env文件 #

root为MySQL默认用户，无需重复配置MYSQL_USER和MYSQL_PASSWORD：

MYSQL_DATABASE=swagger_api
MYSQL_ROOT_PASSWORD=root
MYSQL_PORT=3306

连接测试步骤 #

1. 重置容器与数据卷：

docker-compose down -v

2. 重新启动容器：

docker-compose up -d

3. 本地客户端连接参数：

• 主机：127.0.0.1（MacOS下优先用IP而非localhost，避免socket连接冲突）
• 端口：.env中配置的MYSQL_PORT
• 用户：root
• 密码：root
• 数据库：swagger_api

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