Docker环境下PostgreSQL启动后如何运行Prisma数据库迁移

你把yarn migrate放在Dockerfile的RUN指令中执行是错误的：RUN是镜像构建阶段执行的命令，这个阶段不会启动你在编排文件里定义的postgres依赖服务，也不具备运行时服务间的网络连通能力，执行迁移时必然会因为无法连接数据库抛出错误。
Prisma迁移属于需要对接运行中数据库的操作，必须放在容器启动阶段、数据库服务就绪之后执行，不能放在镜像构建阶段。

方案1：启动入口脚本控制执行顺序（开发/通用场景首选） #

核心逻辑是把迁移操作从构建阶段挪到容器启动阶段，先检测数据库连通状态，确认PostgreSQL完全就绪后再执行迁移，最后启动NestJS服务。

1. 修改Dockerfile，删除构建阶段的RUN yarn migrate配置，补充系统依赖和入口脚本配置：

   FROM node:16.13.0-alpine
   # 切root用户安装网络检测依赖
   USER root
   RUN apk add --no-cache netcat-openbsd
   # 切回普通用户保证运行权限安全
   USER node
   WORKDIR /home/node/server
   COPY package.json .
   RUN yarn
   COPY . ./
   RUN yarn generate
   # 给入口脚本加可执行权限
   RUN chmod +x entrypoint.sh
   EXPOSE 4000
   # 启动时执行入口脚本，而非直接启动服务
   CMD ["./entrypoint.sh"]
   

2. 在项目根目录新建entrypoint.sh脚本：

   #!/bin/sh
   # 循环检测数据库端口连通性，直到数据库就绪
   # 把DB_HOST、DB_PORT替换成你自己配置的数据库环境变量
   until nc -z "$DB_HOST" "$DB_PORT"; do
     echo "PostgreSQL未就绪，1秒后重试..."
     sleep 1
   done
   
   echo "数据库已就绪，开始执行Prisma迁移"
   yarn migrate
   
   echo "迁移执行完成，启动API服务"
   yarn start:dev
   

   注意创建完脚本后要在本地给文件加可执行权限：chmod +x entrypoint.sh，避免构建后容器内脚本无执行权限报错。
   如果你用docker-compose编排服务，即使配置了depends_on也不能省略这个等待逻辑——depends_on只会等待postgres容器启动，不会等待数据库服务本身完成初始化、可接受连接。

方案2：单独定义迁移服务（生产环境推荐） #

生产环境更建议把迁移逻辑和API服务运行解耦，在docker-compose中单独配置迁移任务，确保迁移成功执行后再启动API服务，避免多实例部署时重复执行迁移：

version: '3.8'
services:
  postgres:
    image: postgres:14
    environment:
      POSTGRES_USER: your_db_user
      POSTGRES_PASSWORD: your_db_password
      POSTGRES_DB: your_db_name
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U your_db_user -d your_db_name"]
      interval: 2s
      timeout: 2s
      retries: 10

  prisma-migrate:
    build: ./api_server # 替换成你的api服务Dockerfile所在路径
    command: yarn migrate
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      DATABASE_URL: postgresql://your_db_user:your_db_password@postgres:5432/your_db_name?schema=public

  api_server:
    build: ./api_server
    ports:
      - "4000:4000"
    depends_on:
      prisma-migrate:
        condition: service_completed_successfully
    environment:
      DATABASE_URL: postgresql://your_db_user:your_db_password@postgres:5432/your_db_name?schema=public

• 不要尝试在镜像构建阶段通过固定数据库地址执行迁移：构建环境和运行环境网络通常隔离，且构建阶段执行的操作会固化在镜像层，换环境部署时不会重新执行迁移，极易出现代码版本和数据库结构不匹配的问题。
• 不要省略数据库就绪检测：数据库容器启动后需要几秒到几十秒不等的初始化时间，直接启动服务或执行迁移大概率会出现随机的连接失败问题。

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