Docker构建阶段Prisma无法连接Dokku托管PostgreSQL的解决方案咨询

背景 #

• 环境：Dokku
• 数据库：Dokku托管的PostgreSQL实例
• 应用：Next.js

操作步骤 #

1. 使用Dokku创建PostgreSQL数据库
2. 通过Dokku将数据库与Next.js应用关联

报错信息 #

Docker构建过程中出现如下错误：

Can't reach database server at `dokku-postgres-xyz`:`5432`. Please make sure your database server is running at `dokku-postgres-xyz`:`5432`

该错误表明Prisma在Docker容器构建阶段无法连接数据库。

已尝试方案 #

曾通过修改Dockerfile使用构建参数，将PostgreSQL设为可公开访问并成功连接，但出于安全考虑不希望公开数据库。

咨询问题 #

是否存在无需公开数据库即可解决Docker构建阶段Prisma连接数据库问题的方案？

有几种无需公开数据库就能解决该问题的方案，具体如下：

1. 跳过构建阶段的数据库连接（推荐） #

Prisma在构建阶段主要是生成客户端代码，这一步其实不需要连接数据库，仅需schema.prisma文件即可完成。可以通过分阶段构建的方式优化Dockerfile：

• 第一阶段：安装依赖，单独运行prisma generate生成客户端代码
• 第二阶段：复制生成的客户端代码、编译后的应用文件，完成部署

示例Dockerfile片段：

# 构建阶段
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY prisma ./prisma/
# 仅生成客户端，无需连接数据库
RUN npx prisma generate
COPY . .
RUN npm run build

# 生产阶段
FROM node:18-alpine AS production
WORKDIR /app
COPY --from=builder /app/package*.json ./
COPY --from=builder /app/.next ./.next
COPY --from=builder /app/prisma ./prisma/
COPY --from=builder /app/node_modules/.prisma/client ./node_modules/.prisma/client
RUN npm install --only=production
EXPOSE 3000
CMD ["npm", "start"]

2. 让构建容器加入Dokku数据库网络 #

Dokku的数据库容器和应用容器默认处于同一网络，但构建阶段的容器可能不在该网络内。可以通过Dokku的配置让构建容器加入数据库所在网络：

1. 查看数据库容器所在的网络：

dokku postgres:info xyz | grep Network

2. 给应用添加构建时的网络选项：

dokku docker-options:add your-app build "--network=dokku-postgres-xyz-network"

这样构建阶段的容器就能直接访问数据库服务，无需公开数据库端口。

3. 预先生成Prisma客户端并提交到代码库 #

在本地开发环境运行npx prisma generate，生成node_modules/.prisma/client目录后，将该目录提交到Git仓库。这样Docker构建阶段无需再执行prisma generate，也就避免了数据库连接需求。需要注意的是，每次修改schema.prisma后都要重新生成并提交该目录，适合小型项目使用。

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