如何在Docker-Compose中等待数据库服务启动完成？

问题分析 #

你遇到的P1001错误是API启动时PostgreSQL还未完成初始化导致的。虽然Docker Compose v3.8支持depends_on的service_healthy条件，但默认的pg_isready仅检查端口是否监听，无法验证数据库是否完成用户、库的创建流程，所以healthcheck通过后API仍可能连接失败。

方案一：在package.json中编写Node脚本等待数据库就绪 #

如果你的API是Node.js项目，可通过自定义脚本确保数据库完全可用后再启动服务：

1. 创建等待脚本：在项目根目录新建wait-for-db.js

const { Client } = require('pg');

const waitForDb = async () => {
  const dbConfig = {
    host: 'postgresdb',
    port: 5432,
    user: 'myuser',
    password: 'mypassword',
    database: 'mydb'
  };
  const client = new Client(dbConfig);

  let retries = 10;
  while (retries > 0) {
    try {
      await client.connect();
      console.log('数据库连接成功，启动API服务');
      await client.end();
      process.exit(0);
    } catch (err) {
      retries--;
      console.log(`数据库未就绪，剩余${retries}次重试...`);
      await new Promise(resolve => setTimeout(resolve, 2000));
    }
  }
  console.error('无法连接到数据库，启动失败');
  process.exit(1);
};

waitForDb();

2. 修改package.json脚本
   将启动命令改为先执行等待脚本，再启动API：

{
  "scripts": {
    "start": "node wait-for-db.js && node ./src/index.js", // 替换为你的API入口文件
    "dev": "node wait-for-db.js && nodemon ./src/index.js"
  }
}

3. 更新Dockerfile
   确保容器启动时执行npm start：

WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["npm", "start"]

方案二：使用Shell脚本等待数据库（通用方案） #

如果项目不是Node.js，或更倾向于Shell脚本，可采用以下方式：

1. 创建Shell脚本：新建wait-for-db.sh

#!/bin/bash
set -e

# 接收参数：主机、端口、用户、密码、数据库名、后续命令
host="$1"
port="$2"
user="$3"
password="$4"
dbname="$5"
shift 5
cmd="$@"

# 循环尝试连接数据库
until PGPASSWORD="$password" psql -h "$host" -p "$port" -U "$user" -d "$dbname" -c '\q'; do
  >&2 echo "PostgreSQL 未就绪，2秒后重试..."
  sleep 2
done

>&2 echo "PostgreSQL 已就绪，启动服务"
exec $cmd

2. 修改package.json脚本

{
  "scripts": {
    "start": "./wait-for-db.sh postgresdb 5432 myuser mypassword mydb && node ./src/index.js"
  }
}

3. 更新Dockerfile
   添加脚本并赋予执行权限：

COPY wait-for-db.sh /app/
RUN chmod +x wait-for-db.sh
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
CMD ["npm", "start"]

额外优化：完善PostgreSQL的Healthcheck #

为了让depends_on的service_healthy条件真正生效，可以修改PostgreSQL服务的healthcheck，验证数据库是否可正常查询：

postgresdb:
  # ...其他配置
  healthcheck:
    test: ['CMD-SHELL', 'PGPASSWORD=mypassword psql -U myuser -d mydb -c "SELECT 1;"']
    interval: 10s
    timeout: 5s
    retries: 5

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