Ubuntu 20.04下Docker容器内NodeJS连接本地MongoDB失败求助

核心问题定位 #

容器日志报错MongooseServerSelectionError: connect ECONNREFUSED 127.0.0.1:27017，但你配置的连接地址是host.docker.internal，说明要么连接字符串未正确传入容器，要么host.docker.internal被解析为容器内部的127.0.0.1，或者网络层面存在拦截。

一、验证连接字符串是否生效 #

1. 进入容器检查环境变量：

   docker exec -it <你的容器名称> printenv | grep MONGO
   

   确保输出的连接字符串是mongodb://<user>:<pw>@host.docker.internal:27017/my-db-name。
2. 若环境变量未设置，检查docker-compose.yml的环境变量配置，示例：

   services:
     your-service:
       environment:
         - MONGO_URI=mongodb://<user>:<pw>@host.docker.internal:27017/my-db-name
   

3. 手动在容器内测试连接（alpine环境需先安装工具）：

   docker exec -it <你的容器名称> sh
   apk add mongodb-tools
   mongo mongodb://<user>:<pw>@host.docker.internal:27017/my-db-name
   

   手动连接成功则说明代码未正确读取环境变量，失败则继续排查网络问题。

二、修复host.docker.internal解析问题 #

Ubuntu Docker默认不原生支持host.docker.internal，即使配置extra_hosts: - "host.docker.internal:host-gateway"也可能存在解析异常：

1. 获取宿主机的Docker网桥IP或物理网卡IP：

   # 查看docker0网桥IP
   ip addr show docker0
   # 查看物理网卡IP（比如eth0）
   ip addr show eth0
   

2. 修改docker-compose.yml，直接映射到宿主机实际IP：

   services:
     your-service:
       extra_hosts:
         - "host.docker.internal:192.168.1.100" # 替换为你的宿主机IP
   

3. 重启容器：

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

三、确保MongoDB正确绑定并重启服务 #

1. 检查/etc/mongod.conf的绑定IP配置，需包含宿主机的网桥IP或物理IP：

   net:
     bindIp: 127.0.0.1,172.17.0.1,192.168.1.100
   

2. 重启mongod服务：

   sudo systemctl restart mongod
   

3. 验证MongoDB监听地址：

   sudo lsof -i :27017
   

   输出需包含你配置的所有绑定IP。

四、允许容器访问宿主机27017端口 #

Ubuntu的ufw防火墙可能拦截容器请求：

1. 临时关闭防火墙测试：

   sudo ufw disable
   

2. 若测试通过，重新开启防火墙并添加规则：

   sudo ufw enable
   sudo ufw allow from 172.17.0.0/16 to any port 27017 # 允许Docker网桥网段访问
   

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