从主机SQL客户端连接Docker MySQL容器失败问题求助

先梳理下你的配置和操作：

你使用的Docker Compose文件如下：

version: "3"
services:
  my-sql:
    image: mysql
    container_name: my-sql
    ports:
      - 3306:3306
    environment:
      MYSQL_ROOT_PASSWORD: passw0rd
      MYSQL_USER: dbuser
      MYSQL_PASSWORD: pass1234
      MYSQL_DATABASE: connect_test

通过命令docker inspect my-sql | grep IPAddress查到容器内部IP为172.18.0.2，但外部客户端连接失败，大概率是以下几个原因，我给你逐个排查解决：

1. 错误的连接地址（最常见） #

容器内部IP172.18.0.2是Docker桥接网络的内部地址，外部客户端（不在宿主机或同一Docker网络的设备）无法直接访问这个IP。你应该使用宿主机的IP地址（比如宿主机的局域网IP、公网IP，本地测试用127.0.0.1即可）加上映射的3306端口来连接。

正确的连接命令示例：

# 本地测试用127.0.0.1
mysql -h 127.0.0.1 -P 3306 -u dbuser -p

# 局域网内其他设备用宿主机局域网IP
mysql -h 192.168.1.100 -P 3306 -u dbuser -p

2. MySQL绑定地址限制 #

部分MySQL镜像默认会将服务绑定到127.0.0.1，导致只能容器内部访问。你可以修改Compose文件，添加command参数让MySQL绑定到0.0.0.0（允许所有地址访问）：

修改后的Compose文件：

version: "3"
services:
  my-sql:
    image: mysql
    container_name: my-sql
    ports:
      - 3306:3306
    environment:
      MYSQL_ROOT_PASSWORD: passw0rd
      MYSQL_USER: dbuser
      MYSQL_PASSWORD: pass1234
      MYSQL_DATABASE: connect_test
    command: --bind-address=0.0.0.0

修改后重启容器生效：

docker-compose down && docker-compose up -d

3. 数据库用户权限不足 #

你创建的dbuser默认可能只允许从localhost（容器内部）连接，需要给该用户授权允许从外部地址访问：

1. 先进入MySQL容器：

docker exec -it my-sql mysql -u root -ppassw0rd

2. 在MySQL命令行执行授权语句：

# 允许dbuser从任何地址访问connect_test库
GRANT ALL PRIVILEGES ON connect_test.* TO 'dbuser'@'%' IDENTIFIED BY 'pass1234';
# 刷新权限生效
FLUSH PRIVILEGES;

如果想提高安全性，也可以把%换成具体的IP段（比如192.168.1.%）。

完成以上步骤后，再用外部客户端尝试连接，应该就能成功了。

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