Dokploy中Next.js Dockerfile构建时Prisma无法读取DATABASE_URL的问题

我在Dokploy中构建Next.js项目的Dockerfile时，大部分场景运行正常，但当构建过程依赖Prisma时会失败——核心原因是Dockerfile无法将DATABASE_URL传递给Prisma。我已经在Dokploy的构建时密钥中添加了该变量，但只有在Dockerfile里硬编码DATABASE_URL时才能正常执行构建。

当前使用的Dockerfile如下：

# syntax=docker/dockerfile:1

FROM node:22-alpine AS deps

WORKDIR /app

COPY package.json package-lock.json ./

RUN npm ci

# =====================================

FROM node:22-alpine AS builder

WORKDIR /app

COPY --from=deps /app/node_modules ./node_modules
COPY . .

ARG DATABASE_URL
ENV DATABASE_URL=$DATABASE_URL


ENV NODE_ENV=production

RUN npx prisma generate

RUN echo "DATABASE_URL=$DATABASE_URL"

RUN npm run build

# =====================================

FROM node:22-alpine AS runner

WORKDIR /app

ENV NODE_ENV=production
ENV PORT=3000
ENV HOSTNAME=0.0.0.0

RUN addgroup -S nodejs && \
    adduser -S nextjs -G nodejs

COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public

COPY --from=builder /app/prisma ./prisma
COPY --from=builder /app/node_modules/.prisma ./node_modules/.prisma

USER nextjs

EXPOSE 3000

CMD ["node", "server.js"]

排查与解决步骤 #

• 确认Dokploy的构建参数配置
  确保在Dokploy中添加的DATABASE_URL是作为构建阶段参数传递的，而非仅作为容器运行时环境变量。部分平台默认会将密钥设为运行时变量，需要手动勾选“构建时可用”或类似选项，让变量能在builder阶段被读取。

• 验证变量是否成功注入
  查看构建日志中RUN echo "DATABASE_URL=$DATABASE_URL"的输出：

  • 如果输出为空，说明Dokploy未正确传递变量，检查变量名大小写是否完全匹配（必须是DATABASE_URL），以及构建密钥的配置是否生效。
  • 如果输出正确，说明变量已传递，但Prisma未读取到，继续下一步。

• 调整Dockerfile中变量的声明顺序
  将ARG DATABASE_URL移至builder阶段的最顶部，确保在执行npx prisma generate前变量已被加载。同时可以添加兜底方案，生成Prisma专属的环境变量文件：

  # 在builder阶段开头声明ARG
  ARG DATABASE_URL
  # ... 其他复制步骤 ...
  # 设置环境变量的同时生成.prisma/env文件
  ENV DATABASE_URL=$DATABASE_URL
  RUN echo "DATABASE_URL=$DATABASE_URL" > .prisma/env
  

  Prisma会自动读取.prisma/env文件中的变量，即使环境变量注入出现问题，也能保证prisma generate正常执行。

• 检查Prisma依赖的完整性
  确认package.json中已将prisma列为开发依赖，且npm ci在deps阶段正确安装了所有依赖。如果deps阶段未包含Prisma，会导致builder阶段执行prisma generate时出错。

调整后的Dockerfile示例 #

# syntax=docker/dockerfile:1

FROM node:22-alpine AS deps

WORKDIR /app

COPY package.json package-lock.json ./

RUN npm ci

# =====================================

FROM node:22-alpine AS builder

WORKDIR /app

# 提前声明ARG，确保后续命令可访问
ARG DATABASE_URL

COPY --from=deps /app/node_modules ./node_modules
COPY . .

# 设置环境变量并生成Prisma兜底配置文件
ENV DATABASE_URL=$DATABASE_URL
RUN echo "DATABASE_URL=$DATABASE_URL" > .prisma/env

ENV NODE_ENV=production

RUN npx prisma generate

RUN echo "DATABASE_URL=$DATABASE_URL"

RUN npm run build

# =====================================

FROM node:22-alpine AS runner

WORKDIR /app

ENV NODE_ENV=production
ENV PORT=3000
ENV HOSTNAME=0.0.0.0

RUN addgroup -S nodejs && \
    adduser -S nextjs -G nodejs

COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public

COPY --from=builder /app/prisma ./prisma
COPY --from=builder /app/node_modules/.prisma ./node_modules/.prisma

USER nextjs

EXPOSE 3000

CMD ["node", "server.js"]

内容的提问来源于stack exchange，提问作者Guntas Singh Sandhu