Vercel 请求体上限升至 20MiB,附启用条件
Vercel Functions 在公开测试中将请求体上限提高至 20MiB,需设置 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1 并采用 4GB 性能内存配置。Node.js、Python、Bun 及路由中间件适用;Edge 仍受 4.5MB 限制,启用后中间件无法读取请求体。
AI 深度解读
Vercel Functions 的入站请求体上限从 4.5MB 提高到 20MiB,目前处于 Public Beta。接收较大的表单或文件内容时,这能减少请求在进入业务代码前就被大小限制拦下的情况。
但它需要主动开启,还绑定了 4GB 内存配置,并会改变整个项目的 Routing Middleware 行为。是否启用,不能只看业务函数能否接住 20MiB,还要检查运行时和中间件是否满足条件。
20MiB 怎么开,哪些请求能用
开启方式是设置环境变量 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1。项目中的函数还必须使用 performance 内存设置,配置为 4GB。
这个开关按项目、按环境生效,不是只给某个上传接口单独放宽限制。可以先在 preview 环境验证,再在 production 环境启用,不必同时调整两个环境。
支持范围包括 Node.js、Python、Bun 运行时上的函数,以及符合运行时条件的 Routing Middleware。这里放宽的是入站请求体大小,原文没有宣布响应体限制也同步调整。
Edge runtime 仍然保留 4.5MB 上限,超限返回 413。若要使用新上限,需要切换到 Node.js runtime;原文给出的方式包括 runtime: 'nodejs',或在 Next.js 中使用 proxy.ts。
20MiB 是有配置前提、运行时边界和项目级影响的可选能力。
为什么开了大请求体,中间件反而读不到正文
项目启用新上限后,Routing Middleware 仍会执行,也仍能看到请求头和元数据,但拿不到请求体。这个约束在项目层面强制执行。
原因是避免同一份请求体传送两次:一次送给中间件,一次再送给目标函数。对于较大的正文,重复传输会增加成本,也会拉长首字节时间(TTFB)。
对程序员来说,关键是区分两类逻辑。只依赖请求头和元数据的中间件逻辑,仍有原来的输入;需要读取正文才能完成的逻辑,则失去了必要数据。例如,若现有中间件要根据正文内容做校验,就需要重新安排执行位置。
启用前要审查整个项目的中间件,而不只是准备接收大请求的那个接口。
原文还要求尽快读取请求体,并避免让它长时间驻留内存,以防背压和内存问题。背压可以理解为下游处理跟不上,数据继续在传输或处理链路中堆积。上限提高后,应用自身读取和处理正文的方式也更需要检查;4GB 配置并不代表可以随意缓存每个请求的完整正文。
我的判断
这次更新解决的是一个明确的入口限制:符合条件的 Vercel Functions 可以接收更大的请求体。对于原本被 4.5MB 卡住、请求又确实需要交给函数处理的接口,它有直接价值。
但不能据此判断上传速度一定更快,或者成本一定更低。原文没有提供延迟、吞吐量、并发和账单的对照数据;避免向中间件与函数重复传输正文,是设计理由,不是已经展示出来的性能测试结论。
如果需求只是把文件存起来,也应该把对象存储直传作为替代方案一起评估。两者承担的数据路径不同,不能仅凭 20MiB 就认定函数中转更合适。这个对照是站内建议,原文没有给出方案比较。
还要留一个边界:原文没有说超过 20MiB 时的具体处理细节,也没有说明各种框架读取正文的最佳实现,不能自行补成产品承诺。
能拿来做什么
- 给部署在 Vercel 的 Node.js 接口放宽请求大小前,先在 preview 设置
VERCEL_SUPPORT_LARGE_REQUEST_BODY=1,确认函数使用 performance 的 4GB 内存配置,再用实际业务请求验证。 - 检查 Routing Middleware 是否读取正文。若有相关逻辑,先调整到能够读取请求体的处理位置,再启用项目级开关。
- 对仍在 Edge runtime 上运行的相关入口,先评估切换 Node.js 的影响;只设置环境变量,无法解除其 4.5MB 限制。
- 检查大请求的读取与处理流程,尽快消费正文,减少不必要的内存驻留,并观察实际负载下的内存与响应表现。