docker-compose中数据库初始化晚于其他服务启动，首次访问失败如何解决？

• 数据库健康检查逻辑错误：PostgreSQL是TCP协议数据库，不响应HTTP请求，你当前配置的curl -f http://localhost:5432检测永远无法成功，不能正确判断数据库初始化状态。
• depends_on默认行为问题：默认配置下depends_on仅等待依赖容器进入运行状态，不会等待容器内服务完全就绪，因此数据库还在初始化时，web和nginx就会提前启动。
• 端口检测存在局限性：之前使用的wait-for-it.sh仅能检测端口是否可连通，但PostgreSQL端口放开后，还需要数秒完成用户创建、数据库初始化等操作，此时发起数据库连接依然会报错，无法满足等待需求。

方案1（推荐）：配合健康检查实现启动依赖控制 #

该方案不需要修改业务镜像，仅调整docker-compose配置即可生效。

步骤1：修改PostgreSQL健康检查配置 #

使用PostgreSQL官方自带的pg_isready工具做健康检测，该工具会验证数据库服务是否真正可接受连接，准确率远高于端口检测：

healthcheck:
  test: ["CMD-SHELL", "pg_isready -U postgres"]
  interval: 5s
  timeout: 5s
  retries: 5

提示：如果你的数据库用户名不是默认的postgres，需要将上述命令中的postgres替换为实际的用户名。

步骤2：调整depends_on启动条件 #

给web服务的depends_on添加条件，指定等待数据库健康检查通过后再启动：

depends_on:
  db:
    condition: service_healthy

完整修改后的配置 #

version: "3.9"

services:
  db:
    image: postgres:13.3-alpine
    container_name: db
    volumes:
      - ./data/db:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
    ports:
      - "5432:5432"
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5
  web:
    build: .
    container_name: web
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/code
    ports:
      - "8000:8000"
    restart: on-failure
    depends_on:
      db:
        condition: service_healthy
  nginx:
    build: ./nginx
    container_name: nginx
    ports:
      - "80:80"
    restart: on-failure
    depends_on:
      - web

方案2：在web服务启动逻辑中嵌入检测 #

如果不想使用健康检查配置，可以在web的启动命令中加入数据库就绪检测：

1. 首先在web服务的Dockerfile中安装postgresql-client包（Alpine系统执行apk add postgresql-client，Debian/Ubuntu系统执行apt install -y postgresql-client）
2. 修改web服务的启动命令：

command: ["sh", "-c", "until pg_isready -h db -U postgres; do sleep 2; done && python manage.py runserver 0.0.0.0:8000"]

删除本地已有的./data/db目录（避免旧数据干扰测试），执行docker compose up --build重新启动服务，即可看到web和nginx会等到数据库完全初始化完成后再启动，首次运行即可正常访问。

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