Vercel 公测 20 MiB 请求体,上传接口要调整哪些检查
2026 年 11 月 20 日,Vercel 宣布将函数入站请求体上限扩展至 20 MiB,进入需主动启用的公测。对开发 AI 文档助手、图片处理和数据导入工具的团队,这让部分原先因大小被拒的请求有了新的接入选择。本文用一个报告上传接口说明启用条件,以及中间件不能再读正文后,哪些检查应该移到真正处理文件的位置。

原创 AI 概念插画,用货物与通行单解释数据路径,不是产品界面或性能测试。
[配图建议:大件货物进入处理站,旁路关卡只查看通行单 + 蓝色与琥珀色的建筑模型摄影]
新上限要主动启用,也有运行条件
这次变更针对发往函数的请求正文。公告将原有默认值写为 4.5 MB,新公测上限写为 20 MiB;这里沿用官方单位。它覆盖 Node.js、Python、Bun 运行时,Edge 运行时的函数与 Routing Middleware 仍保留原有 4.5 MB 限制。Vercel 公告
假设你在做一个内部报告助手:用户上传 PDF,后端读取文件,再调用解析服务并返回任务编号。过去请求可能在到达业务处理函数之前就触发大小限制。新公测的直接收益,是在符合条件时,让这一类中等体积请求有机会沿用函数入口,而不必仅因入口容量就拆出另一套接收服务。这是接入方案的变化,不是文件解析效果的提升。
目前需要先开启 Fluid compute,将项目函数内存设为 Performance(4 GB),再为目标环境添加下面的变量,并重新部署。Performance 设置面向 Pro 和 Enterprise;Hobby 不能配置为这一档。限制与启用步骤、内存配置说明
VERCEL_SUPPORT_LARGE_REQUEST_BODY=1
开关按项目在所选环境生效,适合先放在 Preview。它不是只给某一个上传路由加容量。检查部署清单时,还要确认路径上是否有 Edge 运行时环节,否则不能仅凭目标函数换了配置,就认定整条请求链已经支持大正文。
[配图建议:环境开关、内存档位和运行时三个实体拨钮共同打开上传通道 + 克制的模型摄影信息图]
中间件仍在运行,但正文检查要搬位置
最容易遗漏的变化发生在 Routing Middleware:项目启用后,它继续收到请求头与元数据,却不能访问请求正文。公告解释,这样避免正文同时送到中间件和目标函数,减少重复传送带来的成本与首字节等待;这不是“所有中间件都被关闭”。中间件行为变更
仍用报告助手举例。假设原来中间件会读取 JSON 中的项目编号,再决定用户能否上传到该项目。启用新模式后,这项依赖正文的逻辑就不能原样留在那里。调整方向是:在能取得正文的处理函数内解析项目编号,结合已认证用户的权限,验证目标项目确实可写,再创建记录或触发后续解析。
检查应跟着所需数据走,而不是跟着旧代码的位置走。 只依赖请求头、路径或会话信息的逻辑,可以按实际框架能力保留;需要文件内容、表单字段或原始正文的逻辑,则应逐项寻找新的执行位置。这里是基于新数据路径的工程建议,不是 Vercel 替应用定义的权限规则。
尤其要检查“改用请求头”这种看似省事的迁移:客户端自己填写的项目编号,只是一个输入。将字段从 JSON 搬到请求头,并不会使它自动变成可信授权依据。无论放在哪一层,仍要与服务端掌握的用户和项目关系核对。
可以先列一张很短的清单:哪段代码调用了正文读取,读取结果用于路由、签名校验还是业务权限,拒绝请求发生在写入之前还是之后。对需要原始字节做签名验证的接口,还要保持原始正文与验证步骤的关系,避免先转换格式再验证另一份数据。
[配图建议:通行单检查留在旁路关卡,正文与项目权限检查移动到接收站 + 建筑模型俯视流程图]
接得进文件,还要考虑怎样读和怎样存
20 MiB 描述请求体容量,不能直接写成“任意 20 MiB 文件都能上传”。例如使用 multipart 表单时,请求还包含边界和其他字段;把二进制文件转成 Base64 放进 JSON,也会增加传输体积。界面上的文件大小与实际发出的请求正文,需要分别观察,不能把上限全部用满后再为额外内容留空间。FormData 说明、Base64 编码规范
Vercel 建议正文到达后尽快读取,尽可能分块处理,以减少背压和内存压力。大请求体读取建议 对应用来说,这意味着要检查当前代码是否先复制一份完整文件,再转成字符串、再解析成另一份对象。入口放宽后,这类处理方式的资源影响也值得重新观察;不能从单个请求的上限推导并发时的内存峰值。
4 GB 是资源档位,也会影响成本结构。Fluid compute 分别计量活跃 CPU、配置内存和调用次数;等待外部解析或 AI 服务时,CPU 计费会暂停,但处理中的内存仍会计量。Fluid compute 计费说明 因而上传完成后若还要等待很久,应结合实际流程比较同步等待与返回任务编号的方案,不能仅凭请求更大就宣称整体更便宜。
对于长视频或持续增长的原始资料,浏览器直接上传对象存储仍是可比较的路径。Vercel 既有上传指南展示了客户端先与服务端交换上传令牌,再将文件直接传给 Blob 的方式;发令牌前需要验证用户是否有权上传。这份指南早于本次公测,这里只引用它的数据路径,不用旧页面推断新上限。客户端直传指南
另外,入站请求放宽没有同步将普通响应体改成 20 MiB;当前限制文档仍单独列出 4.5 MB 响应体上限,流式响应另有规则。请求与响应限制 上传接口返回任务编号与状态、稍后按需要获取结果,往往比一次塞回全部解析内容更容易管理。
[配图建议:函数接收与存储直传两条数据路线并列,分别标注处理站和存储仓 + 简洁的模型摄影比较图]
先在 Preview 验证一条完整上传链
适合优先试用的,是已经使用合适套餐、确有中等体积上传需求,并且能盘清正文处理位置的团队。试用时保留当前生产入口,先在 Preview 启用配置,用不含敏感内容的样例走完整流程。不要以“文件没有报错”作为唯一结果。
可以分三组观察:一组是常见的小文件,确认已有功能正常;一组越过旧限制但低于新上限,确认进入处理函数并形成正确任务;一组超过适用上限,确认用户得到明确提示,系统没有把它登记为已接收成功。平台对超限请求返回 413;若小文件仍失败,应继续检查框架解析器和业务代码自己的限制。超限行为
然后验证权限路径:同一份文件分别提交到有权限和无权限的测试项目,检查被拒请求是否确实没有创建解析任务。对迁走的正文检查,记录执行位置与拒绝原因;日志只保留必要标识,避免为了观察新流程就把整份报告写进日志。
最后记录上传耗时、函数运行、内存相关用量与后续任务状态。新容量只有放进完整上传流程,才会变成用户可见的收益。 如果问题主要是后续解析缓慢,或文件远大于新上限,就应继续设计存储与异步处理,而不是反复调大入口。
[配图建议:同一条上传链上依次摆放容量、权限、任务结果三枚检查标记 + 蓝色与琥珀色模型摄影]
今天先找出谁在读取正文
这次公测值得有上传需求的 Vercel 团队试用,尤其是被旧入口容量卡住的中等文件场景;依赖正文中间件的项目,应先迁好检查再考虑启用。今天可以先搜索上传路径上的正文读取代码,画出它与授权、写入和解析的先后关系。你的接口目前是在接收文件、核对权限,还是等待解析结果时最容易出问题?
[配图建议:一张标出正文读取位置的上传路线草图,旁边放部署检查笔记 + 技术编辑摄影]
资料核查于 2026 年 11 月 22 日。本文依据 Vercel 公告与文档整理;报告助手为说明性场景,未部署测试本次公测。封面为 AI 生成概念图。