如何在构建NextJS 13应用时禁用所有页面的动态预渲染？

针对你的场景，核心思路是阻止Next.js在构建阶段预渲染依赖卷挂载路径的页面，让这些逻辑延迟到应用运行时执行。以下是具体修改方案：

1. 标记页面/全局为动态渲染 #

在App Router中，通过配置强制页面在运行时动态渲染，避免构建阶段预渲染：

• 单个路由生效：在目标路由的page.js或layout.js文件顶部添加：

export const dynamic = 'force-dynamic';

该配置会让当前路由下的所有内容在每次请求时动态生成，构建阶段不会执行相关逻辑。

• 全局生效：在next.config.js中添加全局动态渲染配置：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone', // 适配Docker部署，减少镜像体积
  dynamic: 'force-dynamic', // 全局强制所有页面动态渲染
};

module.exports = nextConfig;

2. 确保卷交互逻辑在服务器组件中执行 #

App Router默认的组件为服务器组件，其代码仅在服务器运行时执行，不会在构建阶段预渲染：

• 将访问卷挂载路径的代码放在page.js、layout.js等无'use client'标记的服务器组件中；
• 若必须在客户端组件中处理卷内容，确保相关逻辑仅在浏览器运行时触发（比如用useEffect包裹，避免构建阶段执行）。

3. 禁用静态生成相关配置 #

如果页面使用了增量静态再生（ISR），需移除或修改相关配置：

• 移除页面中的export const revalidate = xxx，或设置为：

export const revalidate = false; // 等同于force-dynamic，禁止静态再生

4. Docker构建阶段模拟路径（可选） #

若上述配置仍无法避免构建阶段路径检查，可在Dockerfile中提前创建空路径：

# 构建阶段
FROM node:18-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
# 提前创建卷挂载的空目录，避免构建时路径不存在报错
RUN mkdir -p /your/mounted/volume/path
RUN npm run build

# 运行阶段
FROM node:18-alpine AS runner
WORKDIR /app
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
VOLUME /your/mounted/volume/path
EXPOSE 3000
CMD ["node", "server.js"]

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