NextJS+Prisma+Docker PostgreSQL连接异常求助

问题描述 #

我正在开发基于NextJS的应用，使用Prisma连接Docker部署的PostgreSQL数据库，此前配置运行正常，近期突然出现连接错误。

执行Prisma数据填充时触发错误：

94 try {
→ 95   const update1 = await prisma.user.update(
Can't reach database server at `localhost`:`5432`

Please make sure your database server is running at `localhost`:`5432`.

所有Prisma操作（包括数据库迁移）均返回相同错误：

Error: P1001: Can't reach database server at localhost:5432

当前配置 #

连接字符串 #

DATABASE_URL="postgresql://postgres:postgres@localhost:5432/mid-jobs-db?schema=public"

docker-compose.yml 配置 #

version: "3.8"
services:
  postgres:
    image: postgres:13
    restart: always
    container_name: mid-jobs-db
    ports:
      - "5555:5432"
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=postgres
    volumes:
      - my-db:/var/lib/postgresql/data
volumes:
  my-db:

环境与尝试过的操作 #

• Docker Desktop显示容器正常运行，Node版本为v16.13.0
• 已尝试：重启Docker容器、删除容器后重新启动、给连接URL添加?connect_timeout=300
• 将容器端口改为5432:5432后，出现新错误：

Database `mid-jobs-db` does not exist on the database server at `localhost:5432`

补充：未修改过Docker容器配置或连接字符串，一周前环境仍正常，期间可能重启过Mac。

解决方案 #

1. 修正连接端口不匹配问题 #

Docker容器的端口映射是5555:5432，但连接字符串中使用的是5432，这是无法连接的核心原因。直接修改连接字符串的端口为5555：

DATABASE_URL="postgresql://postgres:postgres@localhost:5555/mid-jobs-db?schema=public"

2. 解决数据库不存在的问题 #

当端口改为5432:5432时出现“mid-jobs-db不存在”的错误，是因为docker-compose中POSTGRES_DB设置的是postgres，而非目标数据库名。有两种解决方式：

• 方式一：修改Docker配置初始化目标数据库
  修改docker-compose.yml中的POSTGRES_DB为mid-jobs-db，然后删除现有容器并重新创建（注意：POSTGRES_DB仅在容器首次启动时生效）：

  environment:
    - POSTGRES_USER=postgres
    - POSTGRES_PASSWORD=postgres
    - POSTGRES_DB=mid-jobs-db
  

  执行命令重建容器：

  docker-compose down
  docker-compose up -d
  

• 方式二：手动在容器内创建数据库
  保持现有Docker配置不变，进入容器执行SQL创建数据库：

  1. 进入PostgreSQL容器：

     docker exec -it mid-jobs-db psql -U postgres
     

  2. 创建目标数据库：

     CREATE DATABASE "mid-jobs-db";
     

  3. 退出PostgreSQL命令行：

     \q
     

3. 验证连接有效性 #

修改配置后，执行Prisma迁移命令验证连接是否正常：

npx prisma migrate dev

若命令执行成功，再测试数据填充操作即可。

4. Mac重启后的额外排查点 #

Mac重启后可能出现端口占用或Docker网络异常：

• 检查端口是否被占用：

  lsof -i :5555
  

  若有进程占用，可使用kill -9 <进程PID>终止进程，或更换Docker映射端口。
• 重置Docker网络（仅在其他方法无效时使用，会清除现有容器）：
  点击Docker桌面图标 → 选择Troubleshoot → 点击Reset to factory defaults。

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