Prisma迁移遇P1000错误：Docker化PostgreSQL认证失败

排查与修复步骤 #

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

若本地已安装PostgreSQL服务，会占用默认的5432端口，导致Docker容器的PostgreSQL无法正常对外提供服务：

• Windows：停止本地PostgreSQL服务，执行命令 net stop postgresql-x64-16（版本号需匹配本地安装版本）
• macOS：brew services stop postgresql
• Linux：sudo systemctl stop postgresql
• 重启Docker容器：docker-compose restart postgres

2. 验证PostgreSQL容器运行状态 #

确认容器内数据库配置正常：

• 查看容器启动日志：docker logs threads-db，检查是否出现 database system is ready to accept connections 提示，同时核对日志中初始化的用户名、数据库名、密码与docker-compose.yml配置一致。
• 进入容器测试连接：docker exec -it threads-db psql -U postgres -d threads，若能成功进入数据库，说明容器内配置无问题，问题出在本地到容器的连接链路。

3. 重置PostgreSQL数据卷（解决初始化异常） #

若容器首次初始化失败，可能导致用户/数据库创建不完整：

• 停止并删除容器：docker-compose down
• 删除数据卷（注意：此操作会清空所有数据库数据）：docker volume rm threads_postgres_data
• 重新启动容器：docker-compose up -d，等待初始化完成后再执行迁移命令。

4. 重新生成Prisma客户端 #

确保Prisma加载最新的数据库配置：

npx prisma generate
npx prisma migrate dev --name create_user_table

5. 针对应用在Docker容器内的特殊调整 #

如果你的应用代码也运行在Docker容器中，DATABASE_URL中的localhost指向容器自身，需替换为Docker Compose的服务名postgres：

DATABASE_URL="postgresql://postgres:postgres@postgres:5432/threads"

修改后重启应用容器，再执行迁移命令。

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