docker-compose部署NestJS时Prisma无法连接PostgreSQL报错P1001

你遇到的PrismaClientInitializationError P1001报错，核心原因不是服务间网络配置错误：你在数据库连接串里用服务名postgres作为数据库主机地址的写法是正确的，docker compose默认会为同一项目下的所有服务内置域名解析，容器之间可以直接通过服务名互通。
真正的问题是depends_on字段的默认逻辑存在缺陷：它只会保证postgres容器被拉起，不会等待PostgreSQL数据库服务完成初始化、正式监听5432端口。PostgreSQL容器首次启动时需要完成数据目录初始化、默认用户/库创建、服务启动等流程，整个过程需要数秒时间，你的api服务在数据库还没就绪时就发起Prisma连接，自然会报无法连接的错误。

按以下步骤调整配置即可解决问题：

• 为postgres服务添加健康检查规则，让compose可以准确判断数据库是否真的可以接收连接，同时修改api服务的依赖规则，只有postgres健康检查通过后再启动api服务。
• 统一api服务中DATABASE_URL环境变量的配置，和你后端目录下.env文件的连接串保持一致，补上?schema=public参数，避免后续执行迁移时出现配置不匹配问题。
• （可选，稳定性更高）在api服务启动流程中加入数据库连通性重试逻辑，避免后续运行中数据库短暂重启导致服务直接崩溃。

调整完成后的完整docker-compose.yml配置参考如下：

version: '3.8'
services:
    api:
        build: back-end/
        depends_on:
          postgres:
            condition: service_healthy
        environment:
            DATABASE_URL: postgres://user:password@postgres:5432/db?schema=public
            NODE_ENV: development
            PORT: 3000
        ports:
            - "8080:3000"
        # 可选：不依赖compose健康检查的话，直接在启动命令里加等待逻辑，适配Prisma场景
        # command: sh -c "npx prisma db wait --timeout 30 && npm run start:dev"

    postgres:
        image: postgres:10.4
        ports:
            - "5432:5432"
        environment:
            POSTGRES_USER: user
            POSTGRES_PASSWORD: password
            POSTGRES_DB: db
        healthcheck:
          test: ["CMD-SHELL", "pg_isready -U user -d db"]
          interval: 5s
          timeout: 5s
          retries: 5

配置修改完成后，先执行docker compose down -v清理之前启动的残留容器和卷，再执行docker compose up --build重新启动服务即可。

补充说明：如果你的Prisma版本低于3.8，不支持prisma db wait命令，可以在后端Dockerfile里安装netcat-openbsd工具，用端口探测的方式做等待，循环探测postgres的5432端口，连通后再启动服务即可。

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