Nuxt 3执行npm run dev报错：Cannot read properties of undefined (reading 'modules')

环境信息 #

• Mac 12.5 Monterey
• Node.js v16.17.0
• npm 8.15.0
• 全新初始化的Nuxt项目

报错详情 #

执行npm run dev启动开发服务时，抛出以下错误：

Cannot read properties of undefined (reading 'modules')

完整报错堆栈：

at _sfc_main.setup (./node_modules/nuxt/dist/app/components/nuxt-root.vue:67:16)
at callWithErrorHandling (./node_modules/@vue/runtime-core/dist/runtime-core.cjs.js:157:22)
at setupStatefulComponent (./node_modules/@vue/runtime-core/dist/runtime-core.cjs.js:7107:29)
at setupComponent (./node_modules/@vue/runtime-core/dist/runtime-core.cjs.js:7062:11)
at renderComponentVNode (./node_modules/@vue/server-renderer/dist/server-renderer.cjs.js:172:17)
at renderToString (./node_modules/@vue/server-renderer/dist/server-renderer.cjs.js:446:26)
at Object.renderToString$1 [as renderToString] (./.nuxt/dev/index.mjs:472:24)
at Object.renderToString (./node_modules/vue-bundle-renderer/dist/runtime.mjs:173:40)
at processTicksAndRejections (node:internal/process/task_queues:96:5)
at async ./.nuxt/dev/index.mjs:521:21

可行的解决方案 #

以下是社区中遇到相同问题时验证有效的解决步骤：

• 清理依赖并重新安装
  删除项目下的node_modules文件夹和package-lock.json文件，重新安装依赖：

  rm -rf node_modules package-lock.json
  npm install
  

• 清除Nuxt缓存
  删除Nuxt生成的.nuxt缓存文件夹，再重启开发服务：

  rm -rf .nuxt
  npm run dev
  

• 检查版本兼容性
  确认当前使用的Nuxt版本与Node.js v16.17.0兼容，若存在版本冲突，可尝试升级或降级Nuxt包版本。

• 排查初始化配置
  回顾项目初始化时的选项选择，避免启用了存在冲突的模块或配置项，必要时可重新初始化一个干净的项目测试。

内容的提问来源于stack exchange，提问作者Eugène Carmona