Docker容器间MySQL连接失败求助：Web容器无法连接同机MySQL容器

嘿，我碰到过好几次这种情况，咱们一步步来排查解决！

首先得戳破最常见的坑：你的Web容器里如果用localhost或者127.0.0.1去连MySQL，那它找的是Web容器自己的localhost，不是主机的！下面分情况给你说解决方案：

快速临时解决：用主机内网IP连接 #

1. 先在主机上查自己的内网IP（Linux用ip addr，Windows用ipconfig），假设查到是192.168.3.10
2. 进入Web容器，用这个IP尝试连接MySQL：

   mysql -h 192.168.3.10 -u root -p
   

3. 如果还是连不上，检查两个关键配置：
   • MySQL配置文件my.cnf里的bind-address是不是设成了0.0.0.0（如果是127.0.0.1，那只有主机能连，容器访问不了）
   • MySQL用户权限：确保你用的用户允许从容器所在IP段访问，比如创建一个支持全局访问的用户：

     CREATE USER 'webuser'@'%' IDENTIFIED BY 'your_strong_password';
     GRANT ALL PRIVILEGES ON your_db.* TO 'webuser'@'%';
     FLUSH PRIVILEGES;
     

最优方案：用Docker自定义网络实现容器互通 #

端口映射本来是给外部访问用的，容器之间通信最好用Docker自带的网络功能，更稳定也更安全：

1. 创建一个自定义Docker网络：

   docker network create my_app_network
   

2. 重新启动MySQL容器，加入这个网络（不用-p映射也没关系，除非你需要外部直接访问数据库）：

   docker run -d \
     --name mysql-db \
     --network my_app_network \
     -e MYSQL_ROOT_PASSWORD=yourpass \
     -e MYSQL_DATABASE=your_db \
     mysql:latest
   

3. 启动Web容器时也加入同一个网络：

   docker run -d \
     --name web-server \
     --network my_app_network \
     -p 80:80 \
     your_web_image:tag
   

4. 现在在Web容器里，直接用MySQL容器的名字mysql-db作为主机名就能连接了！比如你的数据库连接串可以写成：

   jdbc:mysql://mysql-db:3306/your_db?user=root&password=yourpass
   

额外排查点 #

• 检查主机防火墙：有没有挡住容器到主机3306端口的访问？可以临时关闭防火墙试试，或者添加允许容器IP段访问的规则
• 进入Web容器后先ping主机IP，确认网络连通性，排除基础网络问题

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