执行npx prisma migrate dev遇P1001错误：无法连接localhost:5432数据库

问题描述 #

执行npx prisma migrate dev时触发Error: P1001，提示无法连接localhost:5432的数据库，但Docker Desktop显示PostgreSQL容器已在5432端口正常运行。已尝试在连接字符串添加connect_timeout=300、更换多个PostgreSQL和Docker版本，问题仍未解决。

相关配置文件（docker-compose.yml）：

version: "3.1"
services:
  postgres:
    image: postgres
    container_name: postgresprisma
    restart: always
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=santino2002
    ports:
      - "5432:5432"
    volumes:
      - postgres:/var/lib/postgresql/data

volumes:
  postgres:

排查与解决步骤 #

1. 检查本地5432端口是否被占用 #

Docker映射的5432端口可能被本地其他PostgreSQL进程或服务占用，导致Prisma连接到本地进程而非Docker容器：

• macOS/Linux：执行lsof -i :5432查看占用进程，用kill -9 <PID>杀掉对应进程
• Windows：执行netstat -ano | findstr :5432找到PID，打开任务管理器结束该进程

如果不想杀掉进程，可修改docker-compose.yml的端口映射，比如改为5433:5432，同时更新Prisma连接字符串中的端口为5433。

2. 修正Prisma连接字符串的主机地址 #

在部分系统环境中，localhost无法正确指向宿主机的Docker容器，需替换为host.docker.internal：
连接字符串示例：

postgresql://postgres:santino2002@host.docker.internal:5432/postgres?schema=public

同时确认连接字符串中的用户名、密码与docker-compose.yml中的POSTGRES_USER、POSTGRES_PASSWORD完全一致。

3. 验证Docker容器内的数据库状态 #

进入容器确认PostgreSQL正常运行且数据库存在：

docker exec -it postgresprisma psql -U postgres

执行\l查看数据库列表，确认postgres数据库已创建；若启动异常，查看容器日志排查：

docker logs postgresprisma

4. 重新生成Prisma客户端 #

旧的连接配置可能被缓存，执行以下命令刷新：

npx prisma generate

之后再尝试执行npx prisma migrate dev。

5. 检查防火墙设置 #

本地防火墙可能阻止了5432端口的入站/出站连接，暂时关闭防火墙或添加允许规则，再测试连接。

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