P1001数据库连接失败求助：已尝试多种方案仍无法解决

我几乎试遍了这个错误的所有可能解决方案，但都没用。数据库连接到底哪里错了？我用VS Code扩展测试过连接，完全正常。

Prisma连接URL #

DATABASE_URL=postgresql://postgres:8aK3e3L6EfbA@postgres:5432/habits_tracker?schema=public&connect_timeout=300&connection_limit=5

docker-compose.yml配置 #

services:
  frontend:
    container_name: frontend
    build: ./habits-tracker-frontend
    restart: always
    ports:
      - '3000:3000'
  backend:
    container_name: backend
    build: ./habits-tracker-backend
    restart: always
    ports:
      - '3001:3001'
    depends_on:
      postgres:
        condition: service_healthy
  postgres:
    container_name: postgres
    image: postgres
    restart: always
    environment:
      POSTGRES_PASSWORD: 8aK3e3L6EfbA
      POSTGRES_DB: habits_tracker
    ports:
      - '5432:5432'
    healthcheck:
      test: ['CMD', 'pg_isready', '-U', 'postgres', '-d', 'habits_tracker']
      interval: 10s
      timeout: 5s
      retries: 5
  adminer:
    container_name: adminer
    image: adminer
    restart: always
    ports:
      - '8080:8080'

后端Dockerfile #

FROM alpine

FROM node

WORKDIR /app

EXPOSE 3001

COPY package*.json ./

RUN npm install

COPY . ./

RUN npx dotenv -e .env.local -- prisma generate

RUN npx dotenv -e .env.local -- prisma migrate dev --name init

RUN npx dotenv -e .env.local -- prisma db seed

CMD ["npm", "run", "dev"]

排查要点与解决方案 #

1. Docker构建阶段的网络问题 #

后端Dockerfile在构建镜像时执行了prisma migrate dev和db seed，但此时容器还未加入docker-compose的自定义网络，无法通过postgres主机名访问数据库。VS Code扩展能连接是因为用了宿主机端口5432，但构建阶段的容器不在同一网络，自然连不上。

解决方法：
把迁移和种子操作移到容器启动时执行，而非构建阶段，修改Dockerfile：

FROM node

WORKDIR /app

EXPOSE 3001

COPY package*.json ./

RUN npm install

COPY . ./

RUN npx dotenv -e .env.local -- prisma generate

# 替换构建阶段的migrate和seed为启动时执行
CMD ["sh", "-c", "npx dotenv -e .env.local -- prisma migrate dev --name init && npx dotenv -e .env.local -- prisma db seed && npm run dev"]

2. 确认.env.local文件已正确复制 #

检查后端项目的.dockerignore是否排除了.env.local，如果没复制到容器里，dotenv无法读取正确的连接URL。确保.dockerignore里没有.env.local（或明确允许复制）。

3. Prisma连接URL的兼容性 #

可以尝试去掉connection_limit参数（Prisma自身有连接池配置，可能和URL参数冲突），简化为：

DATABASE_URL=postgresql://postgres:8aK3e3L6EfbA@postgres:5432/habits_tracker?schema=public&connect_timeout=300

4. 验证数据库健康检查有效性 #

手动进入postgres容器执行pg_isready -U postgres -d habits_tracker，确认数据库能正常响应健康检查命令，避免健康检查误判导致后端提前启动。

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