Next.js生产构建报错：'.next'目录未找到，执行npm run build后问题仍存在

报错详情 #

错误：在'.next'目录中找不到生产构建产物。请在启动生产服务器前先执行'next build'构建你的应用。
报错位置：setupFsCheck (E:\crs admin and client\skillonorofffrontend\node_modules\next\dist\ser...)

已确认前提 #

已执行npm run build命令，但问题重复出现。

排查与解决步骤 #

• 检查build命令是否实际成功执行
  查看终端执行npm run build的输出日志，确认是否有编译错误（比如语法错误、依赖缺失、资源路径错误等）。很多时候build命令看起来执行了，但实际中途失败，没有生成完整的.next目录。
• 确认.next目录的生成位置
  检查项目根目录下是否存在.next文件夹。如果不在根目录，可能是配置了自定义的构建输出路径：
  打开next.config.js，查看是否有distDir配置项，比如：

  module.exports = {
    distDir: 'build'
  }
  

  如果有自定义路径，启动生产服务器时需要指定正确的目录，或者修改distDir回到默认的.next。
• 清理缓存后重新构建
  执行以下命令清理Next.js缓存和node_modules缓存，再重新构建：

  rm -rf .next node_modules/.cache
  npm install
  npm run build
  

  Windows系统可以用：

  rmdir /s /q .next && rmdir /s /q node_modules\.cache
  npm install
  npm run build
  

• 检查文件权限问题
  确保当前用户对项目目录有读写权限，避免构建过程中因权限不足无法创建.next目录或写入文件。
• 确认启动命令的正确性
  生产环境启动命令应为next start，如果是自定义脚本，检查package.json中的scripts配置，比如：

  "scripts": {
    "build": "next build",
    "start": "next start"
  }
  

  不要误将开发环境的next dev当作生产启动命令。

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