切换Node.js兼容版本后仍无法启动Next.js服务的问题求助

排查与修复步骤 #

• 先确认当前终端实际使用的Node版本
  别只看nvm的版本列表，直接执行node -v，如果显示还是16.16.0，说明nvm的版本切换没有在当前终端生效。

• 强制切换并验证版本
  执行nvm use 18.17.0（或20.11.0），执行完成后立刻再次运行node -v确认版本是否切换成功。如果依旧不行，设置默认版本：nvm alias default 18.17.0，之后重启终端再尝试。

• 检查全局Node版本是否冲突
  你可能之前通过系统包管理工具、官网安装包等其他方式安装过Node，导致nvm的版本没有覆盖全局版本。执行which node查看Node的路径，如果路径不是~/.nvm/versions/node/xxx/bin/node这类nvm相关路径，说明全局版本还是16.16.0。可以卸载系统全局的Node，或者调整环境变量让nvm的路径优先级更高。

• 检查编辑器终端的环境配置
  如果是在VS Code这类编辑器的终端中操作，可能编辑器没有加载nvm的环境配置。试试重启编辑器，或者在终端中手动执行source ~/.bashrc（使用bash时）、source ~/.zshrc（使用zsh时）加载nvm配置。

• 清理Next.js缓存重试
  缓存可能残留了旧的环境信息，执行rm -rf .next node_modules package-lock.json删除缓存和依赖文件，然后重新执行npm install，再启动服务。

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