Docker部署Node+TypeScript+MongoDB API时Mongoose连接失败求助

1. 修正MongoDB连接地址（核心问题） #

在Docker Compose的网络环境中，每个服务容器拥有独立的网络命名空间，localhost/127.0.0.1指向容器自身，而非MongoDB容器。必须使用Docker Compose中MongoDB服务的名称（mongo）作为连接主机名。

操作步骤： #

• 在db.ts文件中，调整MongoDB连接逻辑，从环境变量读取连接地址：

import mongoose from 'mongoose';

const connectDB = async () => {
  try {
    const mongoUri = process.env.MONGODB_URI || 'mongodb://mongo:27017/mydatabase';
    await mongoose.connect(mongoUri);
    console.log('MongoDB连接成功');
  } catch (error) {
    console.error('MongoDB连接失败:', error);
    process.exit(1);
  }
};

export default connectDB;

• 在docker-compose.yml中给app服务添加MONGODB_URI环境变量，统一连接配置：

version: '3.8'

services:
  app:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "3000:3000"
    depends_on:
      - mongo
    environment:
      - NODE_ENV=production
      - MONGODB_URI=mongodb://mongo:27017/mydatabase
  mongo:
    image: mongo
    ports:
      - "27017:27017"
    volumes:
      - mongodb_data:/data/db

volumes:
  mongodb_data:

2. 处理MongoDB服务未就绪的问题 #

depends_on仅保证MongoDB容器启动，但不保证MongoDB服务完成初始化。如果应用在MongoDB就绪前尝试连接，会触发连接拒绝错误。

解决方案：添加服务等待机制 #

• 安装wait-for-it工具，用于等待MongoDB端口就绪：

npm install wait-for-it --save-dev

• 修改package.json的启动脚本，让应用等待MongoDB就绪后再启动：

{
  "scripts": {
    "build": "tsc",
    "start": "wait-for-it mongo:27017 -- node dist/index.js"
  }
}

• 修正Dockerfile中的编译步骤，确保TypeScript代码被正确编译：

# Use the official Node.js LTS image
FROM node:lts

# Set the working directory inside the container
WORKDIR /usr/src/index

# Copy package.json and package-lock.json to the working directory
COPY package*.json ./

# Install dependencies
RUN npm install

# Copy the rest of the application code
COPY . .

# Build TypeScript code
RUN npm run build

# Expose port 3000 for the Node.js application
EXPOSE 3000

# Start the Node.js application
CMD ["npm", "start"]

3. 验证修复 #

执行以下命令重启服务：

docker-compose down && docker-compose up --build

此时应用应成功连接MongoDB，控制台会输出MongoDB连接成功的日志。

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