容器化Express应用无法连接MongoDB：ECONNREFUSED错误排查

核心问题是你的Express应用在容器内尝试连接localhost:27017，但容器的localhost指向自身而非MongoDB容器。Docker容器间需通过容器名称/服务名在同一网络内通信，而非localhost。

一、修改应用的MongoDB连接配置 #

打开server.js，找到MongoDB连接字符串，将其中的localhost替换为MongoDB容器的名称（或docker-compose中的服务名mongodb）：

示例修改 #

原连接代码（错误）：

mongoose.connect('mongodb://root:root@localhost:27017/your-db-name?authSource=admin');

修改后（正确）：

mongoose.connect('mongodb://root:root@mongodb:27017/your-db-name?authSource=admin');

更灵活的方式：用环境变量传递地址 #

1. 在Dockerfile中添加环境变量：

ENV MONGO_DB_HOST=mongodb \
    MONGO_DB_USERNAME=root \
    MONGO_DB_PWD=root

2. 在server.js中读取环境变量构建连接字符串：

const mongoHost = process.env.MONGO_DB_HOST || 'localhost';
const mongoUser = process.env.MONGO_DB_USERNAME;
const mongoPwd = process.env.MONGO_DB_PWD;

mongoose.connect(`mongodb://${mongoUser}:${mongoPwd}@${mongoHost}:27017/your-db-name?authSource=admin`);

二、确保容器在同一网络中 #

手动运行容器时 #

你已经指定了--net mongo-network，确保所有容器（mongodb、mongo-express、nxapp）都加入这个网络即可。

使用docker-compose时 #

docker-compose会自动创建一个专属网络，所有services默认在同一网络内，只需保证服务名正确（你的配置中MongoDB服务名为mongodb，和连接字符串中的一致即可）。

三、优化docker-compose配置（可选但推荐） #

给应用服务添加依赖和重启策略，避免因MongoDB未就绪导致的连接超时：

nxapp:
  build: .
  ports:
    - 3000:3000
  depends_on:
    - mongodb  # 等待MongoDB容器启动后再启动应用
  restart: on-failure  # 连接失败时自动重启应用
  environment:
    - MONGO_DB_HOST=mongodb  # 传递MongoDB地址的环境变量

四、验证修改 #

1. 重新构建镜像：docker build -t nxapp .
2. 启动容器（或用docker compose up -d）
3. 查看应用日志：docker logs nxapp，确认无连接错误

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