Vercel Functions 现支持最大 20MiB 的请求体

Vercel Functions 现支持最大 20MiB 的请求体

💡 原文英文,约300词,阅读约需1分钟。
📝

内容提要

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。

🏷️

标签

➡️

继续阅读