Docker Compose配置API依赖MongoDB就绪启动的实现方法

问题1：如何检查MongoDB是否就绪 #

最靠谱的方式是用MongoDB官方的mongosh工具执行ping命令验证服务状态：

mongosh --host mongodb --eval "db.adminCommand('ping')"

当返回结果包含"ok" : 1时，说明MongoDB已经完全就绪，可以接受连接。
也可以用nc检查端口是否开放，但这种方式只能确认容器网络连通，无法保证服务内部已初始化完成，所以优先用mongosh。

问题2：如何配置API依赖MongoDB #

Docker Compose的depends_on默认只等待目标容器启动，不会等服务就绪。要实现等待服务就绪，有两种常用方案：

方案一：用MongoDB健康检查配合depends_on条件判断 #

给MongoDB服务添加健康检查，让Compose能识别服务是否就绪；然后API服务通过depends_on的condition字段，等待MongoDB健康状态达标后再启动。

修改后的完整docker-compose.yml #

version: '3.8'
services:
  mongodb:
    networks: [ "local-fw-net" ]
    hostname: mongodb
    image: mongo:latest
    ports:
      - "27017:27017"
    volumes:
      - ./init-mongo.js:/docker-entrypoint-initdb.d/init-mongo.js
    healthcheck:
      test: ["CMD", "mongosh", "--host", "localhost", "--eval", "db.adminCommand('ping')"]
      interval: 5s
      timeout: 5s
      retries: 5
      start_period: 10s
  api:
    networks: [ "local-fw-net" ]
    hostname: api
    image: api:latest
    ports:
      - "3555:3555"
    depends_on:
      mongodb:
        condition: service_healthy
networks:
  local-fw-net:

方案二：在API启动命令中添加等待逻辑 #

如果你的API镜像里没有mongosh，可以在启动命令里加循环检测逻辑，直到MongoDB就绪再启动API：

修改后的API服务配置片段：

api:
  networks: [ "local-fw-net" ]
  hostname: api
  image: api:latest
  ports:
    - "3555:3555"
  depends_on:
    - mongodb
  command: >
    sh -c "
      until mongosh --host mongodb --eval 'db.adminCommand(\"ping\")'; do
        echo 'Waiting for MongoDB to be ready...'
        sleep 2
      done
      # 替换成你实际的API启动命令，比如 npm start 或者 ./api-server
      npm start
    "

注意：如果API镜像没有mongosh，需要先安装（比如Debian系镜像用apt-get install -y mongodb-mongosh，Alpine系用apk add mongosh）。

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