内容提要
Vercel Functions 现支持最大 20MiB 请求体(原为 4.5MB),处于公开测试阶段。需设置环境变量 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1,且函数须使用 4GB 内存配置。该功能适用于 Node.js、Python、Bun 运行时及 Routing Middleware;Edge 运行时仍限 4.5MB,超限返回 413。启用后中间件不再接收请求体,以避免重复传输。处理大请求体时应及时读取,避免占用内存。
延伸解读
启用条件与适用范围
要使用20MiB请求体,需设置环境变量VERCEL_SUPPORT_LARGE_REQUEST_BODY=1,且项目函数必须使用4GB内存配置。该功能适用于Node.js、Python、Bun运行时及Routing Middleware,但Edge运行时仍限4.5MB,超限返回413。若需更大限制,需将Edge运行时切换至Node.js运行时。
中间件行为变化
启用大请求体后,Routing Middleware将不再接收请求体,仅能访问请求头与元数据,且此限制在项目级别强制执行。中间件仍会运行并看到其他请求头,但依赖请求体的中间件逻辑将不可用。此举避免请求体被重复发送至中间件和目标函数,从而控制成本与首字节时间。
处理大请求体的注意事项
处理较大请求体时,应及时读取请求体,避免将其长时间保留在内存中,以防止背压和内存问题。这一建议有助于维持函数性能稳定,尤其在启用4GB内存配置后,仍需注意内存使用效率。
Q&A
Vercel Functions 现在支持多大的请求体?
Vercel Functions 现在支持最大 20MiB 的请求体,之前限制为 4.5MB。该功能处于公开测试阶段。
如何启用 Vercel Functions 的大请求体支持?
需要设置环境变量 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1,并且项目函数必须使用 4GB 内存配置。该设置应用于设置环境变量的整个项目环境,可以在预览环境测试后再在生产环境启用。
哪些运行时支持 20MiB 的请求体?
支持 Node.js、Python 和 Bun 运行时,以及 Routing Middleware。Edge 运行时仍然限制为 4.5MB,超过会返回 413 错误。
启用大请求体后,中间件还能接收请求体吗?
不能。启用后,Routing Middleware 只接收请求头和元数据,不接收请求体。这是为了避免请求体被重复传输到中间件和目标函数,从而增加成本和延迟。
处理大请求体时需要注意什么?
应及时读取请求体,避免将其长时间保留在内存中,以防止背压和内存问题。
Edge 运行时能使用 20MiB 的请求体吗?
不能。Edge 运行时仍然限制为 4.5MB,超过限制会返回 413 错误。要使用更大的限制,需要切换到 Node.js 运行时(设置 runtime: 'nodejs')或使用 Next.js 中的 proxy.ts。