Next.js 14.2.1新项目报错TypeError: rt.toLowerCase is not a function

问题详情 #

创建Next.js 14.2.1新项目后，启动时抛出如下异常：

uncaughtException: TypeError: rt.toLowerCase is not a function
    at C:\Users\Mohamed\Desktop\next_projects\ecommerce\ecommerce-app\node_modules\next\dist\compiled\webpack\bundle5.js:30:274042

已尝试执行rm -rf node_modules后重新npm install，但问题依旧。

可行解决方案 #

• 清理Next.js缓存：执行命令 npx next clean，清除框架生成的缓存文件，解决缓存损坏导致的webpack编译异常。
• 校验Node.js版本：确保使用的Node.js版本符合Next.js 14.2.1要求（官方推荐v18.17+或v20.6+），版本不兼容可能引发依赖编译问题。
• 更换包管理器：删除node_modules和package-lock.json后，改用yarn或pnpm重装依赖：

  rm -rf node_modules package-lock.json
  yarn install # 或 pnpm install
  

• 检查项目配置：排查next.config.js、tsconfig.json等配置文件，确认没有错误的路径配置或未定义变量，这类错误可能触发webpack编译阶段异常。
• 临时降级Next.js版本：修改package.json中next依赖版本为14.2.0，执行npm install后重试，排查是否为14.2.1版本的特定bug。

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