如何解决Next.js项目启动npm时出现的ENOENT错误？

问题重现 #

启动项目时触发如下错误：

▲ Next.js 14.0.1
Local: http://localhost:3000
[Error: ENOENT: no such file or directory, open 'C:\Users\User\Desktop\react app\new-react-app.next\BUILD_ID'] {errno: -4058,code: 'ENOENT',syscall: 'open',path: 'C:\Users\User\Desktop\react app\new-react-app.next\BUILD_ID'}

解决方案 #

• 清理Next.js构建缓存
  手动删除项目根目录下的.next文件夹，然后重新执行 npm run dev 启动开发服务。

• 重新安装项目依赖

  1. 删除node_modules文件夹和package-lock.json文件
  2. 执行 npm install 重新安装所有依赖
  3. 再次运行 npm run dev

• 修复项目路径问题
  当前项目路径包含空格（react app），Windows环境下路径空格可能导致文件读取异常。将项目移动到无空格的路径下，比如C:\Users\User\Desktop\react-app\new-react-app，再尝试启动。

• 确认启动脚本正确性
  检查package.json中的scripts配置，确保开发环境使用的是 "dev": "next dev"，而非生产环境的"start": "next start"（next start需要先执行next build生成.next目录及BUILD_ID文件）。

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