使用Vercel Edge Functions流式传输时遇运行时不支持错误

• 升级Vercel CLI到最新版
  旧版本CLI不支持正式的edge运行时，执行以下命令升级：

  npm i -g vercel@latest
  

  验证版本：vercel --version，确保版本在v30及以上（v30起正式支持edge运行时）

• 核对运行时配置的正确性

  • 函数文件配置（以Next.js App Router为例）：确保函数顶部的运行时声明拼写正确，无大小写错误

    export const runtime = 'edge';
    

  • vercel.json配置：避免配置冲突，若在全局配置函数运行时，指定对应版本的运行时包

    {
      "functions": {
        "app/api/**/*.js": {
          "runtime": "@vercel/node@3.0.0"
        }
      }
    }
    

  注意不要同时在函数文件和vercel.json中重复配置运行时，防止冲突

• 清理缓存并重新部署

  • 清除本地构建缓存：vercel build --clean
  • 重新部署到生产环境：vercel deploy --prod
  • 本地开发时，重启vercel dev服务，确保加载最新的配置与依赖

• 检查框架与依赖版本
  若使用Next.js，需确保版本在13.4及以上，旧版本对edge运行时支持不完善，执行命令更新：

  npm update next
  

• 关于experimental-edge无效的说明
  experimental-edge是旧版本CLI的实验性运行时，仅在v28-v29版本中可用，且需要框架开启对应实验性功能。不建议继续使用，直接升级到最新CLI使用正式的edge运行时即可解决问题

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