Docker容器中配置Next.js+SQLite静态站点生成遇连接问题求助

我要搭建一个基于Next.js、SQLite（以Prisma作为ORM）的目录网站，需在构建阶段将动态路由渲染为静态内容，同时支持用户添加条目，因此SQLite数据库需具备读写权限。但目前在Docker容器的构建阶段，我无法让Next.js连接到SQLite数据库。以下是我的相关配置文件，请问我遗漏了什么？

Dockerfile #

FROM node:22-alpine AS base

FROM base AS deps
RUN apk add --no-cache libc6-compat python3 make g++ cmake

WORKDIR /app

COPY package.json package-lock.json* pnpm-lock.yaml* ./
COPY prisma ./prisma/
RUN npm ci

# Clean up build dependencies
RUN apk del python3 make g++ cmake

# Rebuild the source code only when needed
FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

# Create data directory with proper permissions in runner stage
RUN mkdir -p /app/data && chown -R 1001:1001 /app/data && chmod 755 /app/data

RUN npm run build

# Production image, copy all the files and run next
FROM base AS runner
WORKDIR /app

ENV NODE_ENV=production
# Uncomment the following line in case you want to disable telemetry during runtime.
# ENV NEXT_TELEMETRY_DISABLED=1

RUN addgroup --system --gid 1001 nodejs
RUN adduser --system --uid 1001 nextjs

COPY --from=builder /app/public ./public

# Set the correct permission for prerender cache
RUN mkdir .next
RUN chown nextjs:nodejs .next

COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./
COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static
COPY --from=builder --chown=nextjs:nodejs /app/node_modules ./node_modules
COPY --chown=nextjs:nodejs prisma ./prisma/

# Create data directory with proper permissions in runner stage
RUN mkdir -p /app/data && chown -R nextjs:nodejs /app/data && chmod 755 /app/data

# Copy scripts for database operations
COPY --chown=nextjs:nodejs scripts ./scripts/
COPY --chown=nextjs:nodejs start.sh ./start.sh
RUN chmod +x start.sh

USER nextjs

EXPOSE 3000

ENV PORT 3000
ENV HOSTNAME "0.0.0.0"

# Run the startup script first as root, then switch to nextjs user
CMD ["npm", "run", "prod"]

docker-compose.yml #

services:
  app:
    build: .
    ports:
      - 3002:3000
    volumes:
      - data:/app/data:rw
    environment:
      - NODE_ENV=production
    restart: unless-stopped
volumes:
  data:

package.json 中的prod命令 #

"prod": "npx prisma migrate deploy && node server.js"

问题根源与修复方案 #

1. 构建阶段未初始化SQLite数据库 #

在builder阶段执行npm run build时，Next.js预渲染动态路由需要读取SQLite数据，但此时数据库文件尚未创建，Prisma无法建立连接。

修复：
在builder阶段的RUN npm run build之前，添加数据库初始化命令：

# 设置数据库路径环境变量（如果你的schema依赖环境变量）
ENV DATABASE_URL="file:/app/data/db.sqlite"
# 初始化数据库
RUN npx prisma migrate deploy

2. 构建阶段的目录权限问题 #

builder阶段创建/app/data时设置了1001:1001权限，但此时构建进程以root用户运行，后续npm run build访问数据库时可能出现权限冲突。

修复：
简化构建阶段的权限设置，直接给data目录开放读写权限（构建阶段无需严格权限控制，运行阶段再做限制）：

RUN mkdir -p /app/data && chmod 777 /app/data

3. 环境变量缺失 #

如果你的prisma/schema.prisma中数据库URL通过环境变量指定（如下），必须在builder阶段显式设置DATABASE_URL，否则Prisma无法定位数据库文件：

datasource db {
  provider = "sqlite"
  url      = env("DATABASE_URL")
}

修改后的builder阶段示例 #

FROM base AS builder
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .

# 配置数据库路径并初始化
ENV DATABASE_URL="file:/app/data/db.sqlite"
RUN mkdir -p /app/data && chmod 777 /app/data
RUN npx prisma migrate deploy

# 执行构建
RUN npm run build

额外提示 #

• 构建阶段的数据库仅用于预渲染静态内容，运行时的数据库存储在Docker volume中，两者相互独立。如果需要预渲染运行时的真实数据，建议改用Next.js的增量静态再生（ISR），而非在构建阶段依赖运行时数据库。
• 检查构建日志中的具体错误信息（如“文件不存在”或“权限被拒绝”），可更精准定位问题。

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