Docker容器内MySQL无法接受外部客户端凭证问题排查

针对你遇到的容器内可正常连接但Windows终端外部连接报错ERROR 1045 (28000): Access denied for user 'root'@'localhost' (using password: YES)的问题，按以下步骤逐一排查：

1. 检查MySQL用户访问权限 #

容器内创建的root或自定义用户默认可能仅允许**容器内部（localhost）**访问，外部连接需要用户具备远程访问权限：

• 进入容器执行登录命令：docker exec -it [容器名/ID] mysql -uroot -p
• 登录后查看用户权限范围：

  SELECT user, host FROM mysql.user;
  

• 若目标用户的host列显示localhost，需创建或修改用户允许远程访问：

  -- 允许用户从任意IP访问（生产环境建议限制具体IP）
  CREATE USER 'your_user'@'%' IDENTIFIED BY 'your_password';
  GRANT ALL PRIVILEGES ON *.* TO 'your_user'@'%' WITH GRANT OPTION;
  FLUSH PRIVILEGES;
  

2. 确认端口映射与连接目标 #

• 检查docker-compose.yaml的端口配置，确保容器3306端口映射到宿主机：

  services:
    mysql:
      # ...其他配置
      ports:
        - "3306:3306"  # 宿主机端口:容器端口
  

• 如果映射了非默认端口（如3307:3306），外部连接必须指定端口：mysql -uyour_user -p -P 3307
• 若Windows本地安装了MySQL服务，localhost会优先指向本地实例，此时改用127.0.0.1连接：mysql -uyour_user -p -h 127.0.0.1，避免本地服务干扰。

3. 验证密码与终端转义问题 #

• 容器内执行echo $MYSQL_ROOT_PASSWORD（若通过环境变量设置密码），确认密码与外部输入一致。
• 若密码包含特殊字符（如!@#$&），Windows终端可能自动转义导致输入错误，此时用引号包裹密码：mysql -uyour_user -p"your_password"，或交互输入密码。

4. 排查防火墙与网络问题 #

• 临时关闭Windows防火墙测试连接，若恢复正常则需添加对应端口的放行规则。
• 检查Docker网络模式，若使用自定义网络，确认宿主机与容器网络互通（默认bridge模式无需额外配置）。

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