Nuxt3开发服务器启动失败：Cannot read properties of undefined (reading 'port')

按照Nuxt3官方文档步骤搭建新项目：

1. npx nuxi init <project-name>
2. cd <project-name>
3. npm install
4. npm run dev

执行npm run dev时出现错误：

ERROR Cannot read properties of undefined (reading 'port')

完整错误日志：

Nuxi 3.3.1                                                           
Nuxt 3.3.1 with Nitro 2.3.1                                           

 ERROR  Cannot read properties of undefined (reading 'port')          

  at Object.invoke (node_modules/nuxi/dist/chunks/dev.mjs:6777:78)
  at async _main (node_modules/nuxi/dist/cli.mjs:49:20)

目前未编写任何业务代码，怀疑是npm/nvm/node版本问题，当前使用node 18.15.0、npm 9.5.0。请问需要更新到哪个版本？错误排查方向有哪些？

版本适配建议 #

• Node.js：升级到18.16.0+或20.x LTS版本，Nuxt 3.3.x对Node 18的部分小版本存在兼容性问题，18.16.0是经过验证的稳定兼容版本；20.x LTS是当前官方推荐的长期支持版本，兼容性更优。
• npm：建议同步升级到9.6.x+，或切换使用pnpm 8.x（Nuxt官方更推荐pnpm，可避免部分npm版本的锁文件冲突问题）。

错误排查步骤 #

1. 清理依赖缓存并重新安装

   • 执行rm -rf node_modules package-lock.json（Windows系统用rmdir /s node_modules && del package-lock.json）
   • 重新运行npm install
   • 再次尝试启动项目：npm run dev

2. 检查环境与启动参数

   • 确认本地未设置冲突的PORT环境变量，或尝试指定端口启动：npm run dev -- --port 3001
   • 检查项目根目录是否存在.env文件，若为误创建可临时移除后重试

3. 更新nuxi工具

   • 全局更新nuxi：npm install -g nuxi@latest，再重新初始化项目
   • 或直接用最新版nuxi初始化新项目：npx nuxi@latest init <new-project-name>，排除旧版nuxi的潜在问题

4. 验证Node环境有效性

   • 执行node -v和npm -v确认版本已正确切换生效
   • 若使用nvm，执行nvm use <target-version>切换版本后，重新安装依赖并启动项目

内容的提问来源于stack exchange，提问作者Martin Müsli