Next.js本地构建部署报错：缺失prerender-manifest.json文件

常见排查与修复步骤 #

• 检查next.config.js配置
  确认output字段是否正确设置为'export'（静态导出模式），同时移除服务器端渲染相关配置（比如serverRuntimeConfig），因为静态导出不支持SSR特性：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    output: 'export',
    // 保留其他必要配置，移除SSR相关项
  }
  module.exports = nextConfig
  

• 清理构建缓存
  删除.next和out文件夹后重新构建，避免缓存文件干扰：

  # Linux/macOS
  rm -rf .next out
  # Windows命令行
  rmdir /s /q .next out
  

  之后重新执行npm run build或yarn build。

• 排查首页组件问题
  错误提示路径为/page: /，说明首页（app/page.js或pages/index.js）存在异常：

  • 若使用了getServerSideProps或getInitialProps，静态导出模式不支持这些SSR方法，需替换为getStaticProps，或改用客户端数据获取（比如useEffect结合fetch）。
  • 检查组件中是否引用了不存在的静态资源（如图片、文件路径写错），导致预渲染失败。

• 调整Next.js版本
  部分版本存在导出bug，尝试升级或降级到稳定版本：

  npm install next@latest
  # 或指定已知稳定版本，如13.4.12
  npm install next@13.4.12
  

• 检查Windows文件权限
  确保当前用户对D:\arsalan\practice\next\portfolio文件夹拥有读写权限，避免构建时无法生成prerender-manifest.json文件。

极端情况排查 #

若以上方法无效，可创建极简测试页面替换原首页，执行构建验证是否成功。若测试页面正常导出，说明原首页代码存在特定问题，逐步排查引入的组件、数据逻辑等。

内容的提问来源于stack exchange，提问作者Muhammad Arsalan Qadir