Docker容器内应用无法连接Postgres Prisma启动报P1001错误

问题现象 #

• 宿主机直接运行应用可正常连接Postgres容器，应用打包到Docker容器内运行时无法访问数据库
• 旧版Docker下配置host.docker.internal可正常连通，更新Docker版本后方案失效
• 构建阶段Prisma可正常执行migrate迁移操作，仅应用启动阶段无法建立数据库连接
• 同仓库上级目录commence项目使用完全相同配置，可正常运行无连接问题
• 问题复现代码存放于项目公开仓库对应路径下

现有配置 #

数据库连接串 #

DATABASE_URL="postgresql://postgres:postgres@host.docker.internal:5433/thelasthurrah_application?schema=public"

应用服务docker-compose配置（独立compose文件） #

version: '3.8'
services:
    application-service:
        # network_mode: host
        container_name: 'application_service'
        env_file:
            #     - ./.env.production
            - ./environment/.env
        restart: always
        build: .
        image: application_service
        extra_hosts:
            - 'host.docker.internal:host-gateway'
        ports:
            - '4004:4004'
            - '50051:50051'

Postgres服务docker-compose配置（独立compose文件） #

thelasthurrah_application_database:
        image: onjin/alpine-postgres
        container_name: thelasthurrah_application_database
        restart: always
        expose:
            - '5433'
        ports:
            - '5433:5432'
        volumes:
            - thelasthurrah_application_database:/var/lib/postgresql/data

启动报错日志 #

应用启动时抛出Prisma P1001初始化错误：

/usr/src/app/node_modules/@prisma/client/runtime/index.js:44801
application_service  |             reject(new PrismaClientInitializationError(error2.message, this.config.clientVersion, error2.error_code));
application_service  |                    ^
application_service  |
application_service  | PrismaClientInitializationError: Can't reach database server at `localhost`:`5433`
application_service  |
application_service  | Please make sure your database server is running at `localhost`:`5433`.
application_service  |     at /usr/src/app/node_modules/@prisma/client/runtime/index.js:44801:20 {
application_service  |   clientVersion: '3.15.2',
application_service  |   errorCode: 'P1001'

根因定位 #

从报错信息可以直接确认，运行时Prisma读取到的数据库地址是localhost:5433，和配置的host.docker.internal:5433不符，两个核心诱因：

1. Prisma 3.x版本默认会在执行prisma generate构建客户端时，将当前环境的DATABASE_URL硬编码烘焙到生成的客户端代码中。如果构建阶段读取到的DATABASE_URL是localhost地址，即便运行时传入了正确的连接串，客户端也会默认使用构建时硬编码的地址发起连接，这也解释了为什么构建阶段migrate可以正常执行——构建阶段的环境变量是正确的，但运行时没有覆盖硬编码值。
2. 应用和数据库分属两个独立的docker-compose文件，默认处于不同的Docker网络，host.docker.internal的解析在部分新版本Docker桌面版/服务版中存在权限或配置差异，走宿主机转发的链路稳定性差。

修复步骤 #

1. 修复Prisma连接地址硬编码问题
   选择以下任意一种方案即可：

• 初始化Prisma客户端时显式传入运行时环境变量的连接地址，强制覆盖构建时烘焙的值：

const prisma = new PrismaClient({
  datasources: {
    db: {
      url: process.env.DATABASE_URL
    }
  }
})

• 调整Dockerfile，将prisma generate命令从构建阶段移到容器启动脚本中，在应用启动前执行，确保生成客户端时读取的是运行时的正确环境变量。

2. 校验运行时环境变量加载正确性
   进入运行中的应用容器执行echo $DATABASE_URL，确认输出的连接串地址为host.docker.internal而非localhost，排除env_file路径配置错误、文件内配置被其他优先级更高的环境变量覆盖的问题。

3. 替换host.docker.internal为容器网络直连（稳定性最高，不受Docker版本影响）

• 先手动创建两个服务共用的外部Docker网络：

docker network create app-shared-network

• 在两个docker-compose文件的顶层添加网络配置，将两个服务都接入该公共网络：

networks:
  default:
    external:
      name: app-shared-network

• 修改数据库连接串，直接通过数据库容器名访问，注意容器内Postgres默认监听5432端口，不需要用宿主机映射的5433端口：

DATABASE_URL="postgresql://postgres:postgres@thelasthurrah_application_database:5432/thelasthurrah_application?schema=public"

• 重新构建启动两个服务即可，该方案不依赖宿主机转发，跨compose项目的服务互联稳定性远高于host网络转发方案。

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