Docker部署NestJS服务时Prisma迁移异常问题求助

核心问题分析 #

1. 数据库未就绪就执行迁移：depends_on: [postgres]仅保证PostgreSQL容器启动，但数据库服务可能还在初始化（如创建默认库、加载配置），此时执行迁移会直接失败，导致容器异常退出。
2. 迁移命令混用+交互式阻塞：prisma migrate deploy是生产环境命令，prisma migrate dev是开发环境命令，后者会弹出交互式确认提示，在Docker非交互式环境下会卡住，容器无法进入运行状态。
3. 脚本无错误处理：迁移失败后没有终止逻辑，后续命令无法执行，容器停留在CREATED状态。

修复步骤 #

1. 修正entrypoint.sh脚本 #

替换为以下内容，解决数据库等待、命令混用问题：

#!/bin/sh

# 等待PostgreSQL服务完全就绪
wait_for_postgres() {
  until pg_isready -h postgres -p 5432 -U "$POSTGRES_USER"; do
    echo "等待PostgreSQL启动..."
    sleep 2
  done
}

# 执行等待逻辑
wait_for_postgres

# 开发环境统一用migrate dev，自动处理迁移+生成客户端
npx prisma migrate dev --name init --skip-seed
npx prisma generate

# 执行容器主命令
exec "$@"

说明：

• pg_isready是PostgreSQL自带工具，用于检测服务就绪状态，需确保.env中POSTGRES_USER配置正确
• --skip-seed可选，若无需执行种子数据可添加，避免交互式提示
• 开发环境无需同时调用migrate deploy，migrate dev已包含迁移和客户端生成逻辑

2. 优化Dockerfile（可选） #

在构建阶段安装PostgreSQL客户端，确保pg_isready可用：

FROM node:lts

WORKDIR /app

# 安装PostgreSQL客户端（用于pg_isready检测）
RUN apt-get update && apt-get install -y postgresql-client && rm -rf /var/lib/apt/lists/*

COPY package*.json ./
COPY prisma ./prisma/
COPY entrypoint.sh /app/entrypoint.sh
COPY . .

RUN npm i -g @nestjs/cli
RUN npm install

RUN chmod +x /app/entrypoint.sh

EXPOSE 3001 3002 5555
ENTRYPOINT [ "/app/entrypoint.sh" ]
CMD [ "npm", "run", "start:dev" ]

3. 验证环境变量配置 #

确保./backend/.env包含必要数据库配置：

DATABASE_URL="postgresql://POSTGRES_USER:POSTGRES_PASSWORD@postgres:5432/POSTGRES_DB?schema=public"
POSTGRES_USER=你的数据库用户名
POSTGRES_PASSWORD=你的数据库密码
POSTGRES_DB=你的数据库名

4. 测试修复效果 #

执行以下命令重建并启动容器：

docker compose down -v
docker compose up --build

额外注意事项 #

• 生产环境禁止使用migrate dev，应改用migrate deploy，且需提前确保数据库已创建
• 若无需每次启动都执行迁移，可在脚本中添加判断逻辑（如检测迁移表是否存在），仅首次启动时执行
• 开发环境挂载./backend:/app用于热重载，生产环境建议移除该卷，避免代码冲突

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