使用create T3-app创建应用运行npm run dev时出现ReferenceError错误

问题描述 #

使用npm create t3-app@latest创建应用后，进入项目目录执行npm run dev，出现如下异常：

npm run dev             

> accumulator@0.1.0 dev
> next dev

(node:29350) ExperimentalWarning: stream/web is an experimental feature. This feature could change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
/Users/mm/localCode/projects/accumulator/node_modules/next/dist/server/web/spec-extension/request.js:28
class NextRequest extends Request {
                         ^

ReferenceError: Request is not defined
   at Object.<anonymous> (/Users/mm/localCode/projects/accumulator/node_modules/next/dist/server/web/spec-extension/request.js:28:27)
   at Module._compile (node:internal/modules/cjs/loader:1101:14)
   at Object.Module._extensions..js (node:internal/modules/cjs/loader:1153:10)
   at Module.load (node:internal/modules/cjs/loader:981:32)
   at Function.Module._load (node:internal/modules/cjs/loader:822:12)
   at Module.require (node:internal/modules/cjs/loader:1005:19)
   at Module.mod.require (/Users/mm/localCode/projects/accumulator/node_modules/next/dist/server/require-hook.js:64:28)
   at require (node:internal/modules/cjs/helpers:102:18)
   at Object.<anonymous> (/Users/mm/localCode/projects/accumulator/node_modules/next/dist/server/web/spec-extension/adapters/next-request.js:37:18)
   at Module._compile (node:internal/modules/cjs/loader:1101:14)

排查解决建议 #

• 检查Node.js版本：该错误多由Node.js版本过低引发。T3 App依赖的Next.js要求Node.js 18.x及以上的LTS版本，执行node -v查看当前版本，若不满足则升级后重试。
• 重置依赖安装：
  1. 删除项目下的node_modules文件夹
  2. 删除package-lock.json文件
  3. 执行npm install重新安装所有依赖
• 校验Next.js版本兼容性：检查package.json中的next版本，确保与T3 App的默认适配版本一致。若之前手动修改过依赖，重新指定正确版本后执行npm install
• 测试空白项目：新建一个全新的T3 App项目，执行npm run dev测试是否正常。若新项目无问题，说明原项目可能存在配置文件损坏，可逐步迁移代码到新项目。

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