Docker Compose多服务配独立Mongo实例遇Mongoose连接超时问题

以下是针对该问题的具体排查和解决方案：

1. 修正Mongoose连接字符串（最常见原因） #

容器间通信必须使用Docker Compose中定义的服务名作为主机地址，而非localhost或宿主机IP。示例：

• authentication服务的连接字符串：

  mongoose.connect('mongodb://authenticationdatabase:27017/your_auth_db_name');
  

• hosting服务的连接字符串：

  mongoose.connect('mongodb://hostingdb:27017/your_hosting_db_name');
  

容器内部的localhost指向自身，无法访问宿主机或其他容器的MongoDB实例。

2. 确保MongoDB容器允许外部连接 #

默认情况下MongoDB可能仅监听127.0.0.1，需在Docker Compose的MongoDB服务中添加启动参数绑定所有IP：

services:
  authenticationdatabase:
    image: mongo:latest
    command: mongod --bind_ip_all
    # 其他配置（端口、卷映射等）

  hostingdb:
    image: mongo:latest
    command: mongod --bind_ip_all
    # 其他配置（端口、卷映射等）

3. 配置服务依赖与MongoDB就绪检查 #

depends_on仅保证容器启动顺序，无法确保MongoDB服务完全就绪。给MongoDB添加健康检查，让应用服务在数据库可用后再启动：

services:
  authenticationdatabase:
    image: mongo:latest
    command: mongod --bind_ip_all
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
      interval: 5s
      timeout: 5s
      retries: 5

  authentication:
    build: ./authentication
    depends_on:
      authenticationdatabase:
        condition: service_healthy
    # 其他配置

  # hosting服务同理配置依赖与健康检查

4. 确认网络互通性 #

• 确保所有服务处于同一Docker网络（默认bridge网络或自定义网络均可）。若使用自定义网络，需在每个服务中声明：

networks:
  app-network:
    driver: bridge

services:
  authenticationdatabase:
    # ...
    networks:
      - app-network
  authentication:
    # ...
    networks:
      - app-network
  # 其余服务同理

• 进入应用容器测试网络连通性，比如ping对应的MongoDB服务名：

docker exec -it <authentication_container_id> ping authenticationdatabase

若ping不通，检查Docker网络配置是否正确。

5. 排查认证与权限问题（若启用MongoDB认证） #

如果MongoDB设置了用户名密码，连接字符串需包含认证信息：

mongoose.connect('mongodb://username:password@authenticationdatabase:27017/your_auth_db_name?authSource=admin');

同时确保MongoDB容器启动时通过docker-entrypoint-initdb.d目录挂载的初始化脚本，正确创建了用户和数据库权限。

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