Next.js误报Node.js版本过低（实际版本达标）的解决方法

问题描述 #

通过CLI创建Next.js应用后，执行npm run dev时出现版本错误：

You are using Node.js 18.15.0. For Next.js, Node.js version >= 18.17.0 is required.

但本地node -v返回v20.10.0，nvm list显示已安装v22.5.1和system版本，实际版本满足要求。

解决方案 #

1. 确保当前终端会话使用正确的Node.js版本 #

执行命令切换到已安装的高版本Node.js：

nvm use 22.5.1
# 或者设置为默认版本，避免每次重启终端都要切换
nvm alias default 22.5.1

切换后再次验证版本：

node -v

确认版本正确后重新运行npm run dev。

2. 检查项目目录下的.nvmrc文件 #

如果项目根目录存在.nvmrc文件，查看是否指定了旧版本（比如18.15.0）。如果是，修改为你要使用的版本（比如22.5.1或20.10.0），然后重新执行nvm use加载正确版本。

3. 验证npm关联的Node.js版本 #

有时候npm可能绑定了不同的Node.js实例，执行以下命令查看npm对应的Node版本：

npm run env | grep NODE_VERSION

如果输出版本为18.15.0，说明npm未使用nvm管理的版本，可按以下步骤重置：

# 卸载全局npm
sudo npm uninstall -g npm
# 切换到目标Node版本后重新安装npm
nvm use 22.5.1
curl -qL https://www.npmjs.com/install.sh | sh

4. 重启终端或编辑器集成终端 #

如果使用VS Code等编辑器的集成终端，可能未正确加载nvm环境变量。尝试关闭并重新打开终端，或重启编辑器，确保nvm配置生效。

5. 检查system版本的Node.js #

nvm list中的system版本可能就是18.15.0，当前会话可能默认使用了该版本。执行命令确认system版本：

nvm run system --version

如果确实为18.15.0，通过nvm use切换到已安装的高版本，或设置默认版本覆盖system。

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