使用Docker Compose无法将Node.js应用连接到MongoDB的问题排查

问题背景 #

使用Docker Compose部署Node应用和Mongo容器，配置如下：

• 连接字符串：mongodb://user:password@mongo:27017/
• docker-compose.yml配置：

version: '3.8' 

services: 

  mongo: 
    image: mongo
    restart: always
    environment: 
      - MONGO_INITDB_ROOT_USERNAME=user
      - MONGO_INITDB_ROOT_PASSWORD=password


  app:  
    image: app
    build: 
      context: ./app
      dockerfile: Dockerfile 
    ports: 
      - "3000:3000"
    depends_on:
      - mongo

执行后收到连接失败提示：

app_1    | mongodb://user:password@mongo:27017/ {
app_1    |   autoIndex: false,
app_1    |   poolSize: 10,
app_1    |   bufferMaxEntries: 0,
app_1    |   useNewUrlParser: true,
app_1    |   useUnifiedTopology: true
app_1    | }
app_1    | MongoDB connection with retry
app_1    | MongoDB connection unsuccessful, retry after 5 seconds.  2

可能的原因及解决方法 #

1. 连接字符串缺少认证数据库指定 #

你创建的是Mongo的root用户，该用户默认存储在admin数据库中。当前连接字符串未指定认证源，导致Mongo无法匹配到对应的用户信息。

修改连接字符串为：

mongodb://user:password@mongo:27017/?authSource=admin

2. depends_on不保证Mongo服务就绪 #

depends_on仅确保Mongo容器先启动，但Mongo服务需要时间完成初始化（创建用户、启动核心服务），此时Node应用尝试连接会失败。

解决方法：

• 方法一：强化Node应用的重试逻辑：确保连接失败后持续重试，直到Mongo服务完全就绪（你的日志显示已有重试机制，可适当延长重试间隔或增加重试次数）。
• 方法二：给Mongo容器添加健康检查：修改docker-compose.yml，让Node应用仅在Mongo服务健康后启动：

version: '3.8' 

services: 

  mongo: 
    image: mongo
    restart: always
    environment: 
      - MONGO_INITDB_ROOT_USERNAME=user
      - MONGO_INITDB_ROOT_PASSWORD=password
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')", "-u", "user", "-p", "password"]
      interval: 5s
      timeout: 5s
      retries: 5

  app:  
    image: app
    build: 
      context: ./app
      dockerfile: Dockerfile 
    ports: 
      - "3000:3000"
    depends_on:
      mongo:
        condition: service_healthy

3. 检查Mongo容器初始化日志 #

执行以下命令查看Mongo容器的启动日志，确认用户是否成功创建：

docker-compose logs mongo

如果日志中出现用户创建失败的错误，需检查环境变量是否正确，或是否存在配置冲突。

4. 验证容器间网络连通性 #

Docker Compose默认会为服务创建专属网络，mongo服务名应能被app容器解析。若仍有问题，可在app容器中执行ping命令测试：

docker-compose exec app ping mongo

如果无法ping通，检查Docker网络配置是否正常。

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