Docker中MySQL容器无法与Node.js后端容器通信的问题排查

核心误区与排查点 #

1. 容器间通信不能用localhost #

Docker容器的localhost是容器自身，不是宿主机或其他容器。如果MySQL容器要访问后端，必须用后端服务的容器名/服务名（docker-compose里的service name）+ 后端容器内部的端口，而非宿主机映射端口。比如后端服务在docker-compose里叫backend，连接地址应该是backend:4306，不是localhost:4306。

2. 端口配置是否正确 #

• 检查后端Dockerfile是否有EXPOSE 4306声明端口；
• 检查docker-compose.yml里后端服务的配置：容器间通信不需要映射到宿主机，只需通过expose: ["4306"]暴露端口即可；如果需要宿主机访问才加ports: ["4306:4306"]；
• 确认后端服务代码里的端口绑定是0.0.0.0:4306，而非仅绑定127.0.0.1（后者会导致容器外无法访问）。

3. 端口是否真的在监听 #

进入后端容器，验证4306端口是否被服务占用：

docker exec -it <后端容器名> bash
# 若没有netstat则先安装工具
apt update && apt install -y net-tools
netstat -tulpn | grep 4306

如果输出为空，说明后端服务未监听4306端口，需检查代码配置。

4. 容器网络是否互通 #

确认所有容器在同一Docker网络：

• 用docker network ls查看当前网络列表；
• 用docker inspect <容器名>查看容器所属网络，确保MySQL、后端容器在同一网络（docker-compose默认会为所有服务创建专属网络，除非手动指定不同网络）。

5. 不要手动在容器内开放端口 #

Docker容器的端口由Dockerfile或docker-compose配置管理，手动在容器内用iptables修改端口规则无效，且容器重启后会丢失配置。

6. 网络连通性测试 #

进入MySQL容器，先测试与后端的网络连通：

# 测试ping后端服务名（假设服务名为backend）
docker exec -it <mysql容器名> ping backend
# 测试端口连通
docker exec -it <mysql容器名> apt update && apt install -y telnet
telnet backend 4306

如果ping不通，说明网络配置有问题；如果telnet提示连接拒绝，说明后端未开放4306端口。

额外检查点 #

• 服务启动顺序：如果之前正常现在异常，可在docker-compose的MySQL服务中添加depends_on: [backend]确保后端先启动（注意：depends_on仅保证启动顺序，不保证服务就绪，需的话可添加健康检查）；
• 宿主机防火墙：临时关闭宿主机防火墙（如ufw disable），排除防火墙拦截容器间通信的可能。

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