Remix项目本地正常但Vercel部署失败：'AbortController'未找到

1. 对齐本地与Vercel的Node.js版本 #

AbortController在Node.js v15.0.0+才全局内置，若Vercel使用的Node版本低于本地，就可能触发该错误：

• 进入Vercel项目的Settings → General → Node.js Version，设置与本地一致的版本（建议v16及以上）
• 也可在项目根目录创建.nvmrc文件，写入指定版本（如v18.17.0），Vercel会自动读取并使用该版本

2. 手动添加AbortController polyfill #

部分依赖会隐式调用AbortController，而Vercel构建环境未自动注入兼容补丁：

• 安装polyfill包：

  npm install abortcontroller-polyfill --save-dev
  

• 在Remix入口文件（如app/entry.server.tsx或app/root.tsx）顶部引入：

  import 'abortcontroller-polyfill/dist/polyfill-patch-fetch'
  

3. 修正tsconfig.json的类型库配置 #

确保TypeScript编译时包含DOM相关全局类型，避免类型定义缺失：

• 修改tsconfig.json的compilerOptions.lib字段：

  {
    "compilerOptions": {
      "lib": ["DOM", "DOM.Iterable", "ES2022"]
    }
  }
  

4. 检查Remix Vercel适配器配置 #

确认使用官方适配包，避免构建逻辑不兼容：

• 确保已安装@remix-run/vercel：

  npm install @remix-run/vercel --save-dev
  

• 验证vercel.json配置正确性：

  {
    "buildCommand": "remix vite:build",
    "devCommand": "remix vite:dev",
    "installCommand": "npm install",
    "functions": {
      "app/routes/**/*.{js,ts,jsx,tsx}": {
        "runtime": "@remix-run/vercel"
      }
    }
  }
  

5. 定位隐式依赖的包 #

用命令查找哪些依赖在调用AbortController，针对性处理：

• 执行命令：

  npm ls abortcontroller-polyfill
  # 或使用yarn：yarn why abortcontroller-polyfill
  

找到对应包后，查看其文档，确认是否需要升级版本或补充配置

6. 清理Vercel构建缓存 #

缓存残留可能导致旧依赖逻辑未更新：

• 进入Vercel项目的Deployments页面，找到失败的部署记录，点击Redeploy并勾选Skip Build Cache后重新构建

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