启动Next.js开发服务器报错求助：MODULE_NOT_FOUND

问题重现 #

'NextJS\the-wild-oasis-website\node_modules.bin' 无法识别为内部或外部命令、可运行的程序或批处理文件。
node:internal/modules/cjs/loader:1148
throw err;
^
Error: Cannot find module 'W:\Projects\next\dist\bin\next'
at Module._resolveFilename (node:internal/modules/cjs/loader:1145:15)
at Module._load (node:internal/modules/cjs/loader:986:27)
at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:174:12)
at node:internal/main/run_main_module:28:49 {
code: 'MODULE_NOT_FOUND',
requireStack: []
}

解决步骤 #

• 清理并重装依赖

  1. 删除项目下的node_modules文件夹和锁文件：
     Windows命令：

     rmdir /s /q node_modules
     del package-lock.json yarn.lock
     

     macOS/Linux命令：

     rm -rf node_modules package-lock.json yarn.lock
     

  2. 重新安装依赖：npm install

• 检查package.json脚本配置
  打开项目根目录的package.json，确认scripts中的dev字段为：

  "scripts": {
    "dev": "next dev"
  }
  

  避免使用自定义的本地路径引用，直接用官方提供的next dev命令。

• 直接使用npx启动
  绕过本地脚本的路径问题，直接执行：npx next dev

• 清除Node.js缓存
  执行npm cache clean --force，清除缓存后重新执行npm install

• 检查项目路径
  确保项目路径（如W:\Projects\next）没有空格、特殊字符（比如中文、符号），路径过长也可能引发问题，尽量使用简短的路径结构。

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