NextJS报ReferenceError: Request未定义，Node版本检测异常如何解决？

问题根源 #

错误日志显示当前项目使用的Node.js版本为v17.4.0，但你本地全局版本是v20.9.0。Request全局对象在Node.js v18及以上版本才内置支持，v17.x版本没有该对象，导致NextJS的NextRequest继承时出现未定义错误。同时nvm的版本切换未在项目会话中生效，导致项目仍使用旧版本Node。

解决步骤 #

1. 验证当前会话的Node版本 #

执行以下命令确认当前shell和项目实际使用的Node版本：

# 查看当前shell的Node版本
node -v
# 查看nvm当前激活的版本
nvm current
# 检查项目根目录是否存在.nvmrc文件（该文件会指定项目要求的Node版本）
cat .nvmrc 2>/dev/null

2. 切换到正确的Node版本 #

• 如果项目有.nvmrc文件，直接运行：

nvm use

• 若无.nvmrc，手动切换到v20.9.0：

nvm use 20.9.0

• 若要实现进入项目目录自动切换版本，可在shell配置文件（如~/.bashrc或~/.zshrc）中添加以下脚本：

# 自动加载项目.nvmrc指定的Node版本
autoload -U add-zsh-hook
load-nvmrc() {
  local current_node=$(nvm version)
  local nvmrc_path=$(nvm_find_nvmrc)

  if [ -n "$nvmrc_path" ]; then
    local nvmrc_node=$(nvm version "$(cat "$nvmrc_path")")
    if [ "$nvmrc_node" = "N/A" ]; then
      nvm install
    elif [ "$nvmrc_node" != "$current_node" ]; then
      nvm use
    fi
  elif [ "$current_node" != "$(nvm version default)" ]; then
    nvm use default
  fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc

添加后重启终端生效。

3. 清理依赖并重新安装 #

旧依赖可能是基于旧Node版本安装的，执行以下命令重置依赖：

# 删除依赖目录和锁文件
rm -rf node_modules package-lock.json
# 清除npm缓存
npm cache clean --force
# 重新安装依赖
npm install

4. 确认NextJS与Node版本兼容 #

NextJS 13及以上版本要求Node.js 16.14+，NextRequest特性在Node.js 18.x+支持更完善。检查当前NextJS版本：

npm list next

若版本过低，升级到最新兼容版本：

npm install next@latest

5. 重启服务 #

关闭当前终端，重新打开后运行开发服务：

npm run dev

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