Next.js 13.4.12创建项目后执行npm run dev出现服务器模块缺失错误

环境信息 #

• Next.js版本：13.4.12
• Node.js版本：18.17.0

报错内容 #

服务器错误
错误：在React Client Manifest中未找到模块"C:\Users\Kerem\Desktopudb-next\node_modules\next\dist\client\components\app-router.js#default"。这可能是React Server Components打包器存在bug。
该错误发生在页面生成过程中，所有控制台日志将显示在终端窗口中。

可行解决方案 #

• 清理依赖缓存并重装

  1. 删除项目根目录下的node_modules文件夹
  2. 删除package-lock.json（若用yarn/pnpm则对应删除yarn.lock/pnpm-lock.yaml）
  3. 执行npm install重新安装依赖
  4. 再次运行npm run dev

• 检查项目路径是否异常
  报错路径里的Desktopudb-next疑似路径拼接错误，大概率是创建项目时路径包含空格或特殊字符导致解析异常。建议把项目移动到无空格、无特殊符号的目录（比如C:\Projects\udb-next），再重新安装依赖并启动服务。

• 切换Next.js版本
  当前版本可能存在已知打包bug，可尝试：

  • 降级到13.4.11：执行npm install next@13.4.11
  • 或升级到最新稳定版：执行npm install next@latest
    完成后重启开发服务。

• 清除Next.js框架缓存
  执行npx next clean清除框架缓存，再运行npm run dev。

内容的提问来源于stack exchange，提问作者Kerem İlhan