编辑代码后npm run build致.next文件丢失，如何找回及排查？

编辑朋友发来的Next.js网站源码，初始运行正常。修改代码后执行npm run build，发现.next文件夹中的prerender-manifest.js等部分.json和.js文件丢失，导致项目无法正常运行。尝试过npm run start、npm run dev和重新执行npm run build，均未解决问题。

相关截图 #

• 修改前的.next文件夹状态：
• 修改后的.next文件夹状态：
• 辅助排查截图：

• 预渲染逻辑异常：修改代码时改动了getStaticProps/getStaticPaths等预渲染相关代码，比如路径配置错误、异步请求失败、未捕获异常，导致Next.js构建时无法生成预渲染清单文件。
• 依赖版本冲突：新增或更新依赖后，与原有项目依赖（尤其是Next.js版本）不兼容，导致构建流程中生成预渲染文件的步骤中断。
• 文件权限不足：.next文件夹无读写权限，构建时无法写入生成的文件，造成部分文件缺失。
• Next.js配置错误：修改next.config.js时调整了预渲染、输出模式等配置，比如错误开启output: 'export'或禁用预渲染相关功能，导致清单文件无法生成。

• 排查预渲染代码：
  • 检查修改过的getStaticProps/getStaticPaths代码，确保语法正确、异步请求正常返回、路径参数配置无误。
  • 执行npm run build时查看终端错误日志，定位具体失败的预渲染页面。
• 重置依赖：
  • 删除node_modules和package-lock.json，执行npm install重新安装依赖。
  • 核对package.json中Next.js版本，确保与初始可运行版本一致，避免版本兼容问题。
• 修复文件权限：
  • Linux/macOS下执行sudo chmod -R 755 ./your-project-directory，Windows下右键设置项目文件夹为可读写。
• 恢复配置文件：
  • 对比初始版本的next.config.js，恢复可能改错的配置项，比如将output模式改回默认，移除影响预渲染的experimental配置。
• 强制清理缓存构建：
  • 执行npm run build -- --clean强制清理缓存后重新构建，或手动删除.next文件夹再执行npm run build。

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