Vercel News

Skip sending request bodies to Routing Middleware

8.5内容质量

TL;DR · AI 摘要

Vercel 新增 skipMiddlewareRequestBody 配置可跳过中间件请求体传输,显著降低大请求场景的资源消耗。

核心要点

  • 设置 skipMiddlewareRequestBody: true 可减少 100% 的 Fast Origin Transfer 使用量
  • 该配置仅适用于不依赖请求体的路由中间件场景
  • vercel.json 和 vercel.ts 配置方式均支持该选项

结构提纲

按章节快速跳转。

  1. 介绍 skipMiddlewareRequestBody 新特性及其性能优化价值

  2. 明确该配置仅适用于不处理请求体的路由中间件场景

  3. 详细说明在 vercel.json 和 vercel.ts 中的配置语法

  4. 量化说明该配置对 Fast Origin Transfer 使用量的降低效果

  5. 强调默认关闭状态及对现有项目的影响范围

思维导图

用一张图看清主题之间的关系。

查看大纲文本(无障碍 / 无 JS 友好)
  • skipMiddlewareRequestBody 配置
    • 功能价值
      • 降低 Fast Origin Transfer 使用量
      • 提升首字节响应时间
    • 配置方式
      • vercel.json 配置
      • vercel.ts 配置
    • 使用限制
      • 仅适用于无请求体处理逻辑的中间件

金句 / Highlights

值得收藏与分享的关键句。

#Vercel#中间件优化#性能配置#Fast Origin Transfer
打开原文

跳过向路由中间件发送请求体 - Vercel

现在可以通过 skipMiddlewareRequestBody 配置跳过将客户端请求体发送到路由中间件。这可以减少中间件调用时的 Fast Origin Transfer 使用量,并能提升大请求体场景下的首字节响应时间。

仅在路由中间件不读取请求体时启用此选项。Vercel 函数和重写目标仍会接收请求体,因此你可以在这些位置读取和处理请求体。

在项目的 JSON 配置文件 vercel.json 中将 skipMiddlewareRequestBody 设置为 true:

vercel.json

code
1
{
2
"$schema"
:
"https://openapi.vercel.sh/vercel.json"
,
3
"skipMiddlewareRequestBody"
:
true
4
}

通过 vercel.json 跳过向路由中间件转发请求体。

如果你使用的是 TypeScript 配置文件,请改在 vercel.ts 中添加相同配置。此示例假设已安装 @vercel/config:

vercel.ts

code
1
import
type
{
VercelConfig
}
from
'@vercel/config/v1'
;
2
3
export
const
config
:
VercelConfig
=
{
4
skipMiddlewareRequestBody
:
true
,
5
}
;

通过 vercel.ts 跳过向路由中间件转发请求体。

重新部署项目使配置生效。此选项默认为 false,因此现有项目在未启用此选项时不会发生变化。

阅读 skipMiddlewareRequestBody 文档 了解更多信息。