Next.js12自定义服务Docker多阶段构建找不到pages目录如何解决

你出现报错的根本原因是 package.json 中配置了 prestart 钩子，该钩子会在每次执行 npm run start 命令前自动执行 next build，而你生产环境镜像中并没有复制源码层面的 pages 目录，因此触发了构建阶段的目录校验报错。
你之前创建空 pages 目录后报错消失但页面404，也是因为空目录下重新执行的 next build 生成了空的页面产物，覆盖了你提前构建好的 .next 目录内容。

修复步骤 #

• 第一步：删除 package.json 中的 "prestart": "next build" 配置项。多阶段构建已经在构建阶段完成了Next.js产物编译，运行阶段不需要重复执行构建，该钩子属于冗余配置。
• 第二步：修正Dockerfile中的无效配置：
  1. 删掉构建阶段的 CMD mkdir ./pages，CMD 是容器启动时执行的命令，构建阶段不会生效，如果你源码中本来就存在pages目录，完全不需要额外创建。
  2. 将生产阶段的 RUN npm install 替换为 RUN npm ci --only=production，只安装生产依赖，减少镜像体积同时避免开发依赖导致的运行异常。
• 第三步：可选优化自定义服务初始化参数，在你的自定义服务入口中明确传入构建产物路径配置：

const dev = process.env.NODE_ENV !== "production";
const app = next({ 
  dev,
  dir: __dirname, // 明确服务运行的根目录
  conf: {
    distDir: '.next' // 匹配构建阶段生成的产物目录
  }
});

• 第四步：如果有自定义的 next.config.js 配置，确认没有修改 output、distDir 等会影响产物路径的参数，保持和构建阶段一致即可。

验证方案 #

完成上述修改后重新构建镜像并启动容器，此时执行 npm run start 不会再触发重复构建，会直接读取提前复制的 .next 产物运行服务，既不会触发pages目录校验报错，也不会出现404问题，同时保持了多阶段构建的镜像轻量优势。

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