一个后台应用准备加批量导入。典型文件十兆,文件内容一进来就要检查;同一个项目里,还有几条每次只收几千字节的旧接口,入口中间件会读取 JSON,再按其中一个字段决定下游去哪。此时最直接的改动似乎是把上传上限调高。然而新上传能否成功,只是这次改动一半的验收;另一半是旧接口有没有换一种方式读取请求体。小接口不用碰到新上限,也可能因为同一个开关改变行为。
一项入站公测,改变的是整个环境
Vercel 在 2026 年 11 月 20 日的公告把可选的入站请求体上限提高到 20 MiB。这是公测,需要显式设置 VERCEL_SUPPORT_LARGE_REQUEST_BODY=1,并使用 4 GB 性能内存配置。公告列出的函数运行时是 Node.js、Python、Bun;Edge 函数和 Edge Routing Middleware 仍保留原来的 4.5 MB 上限,超限返回 413。旧上限沿用官方的 MB 写法,不擅自换算成 4.5 MiB。二十 MiB 则明确是二十乘以一千零二十四的平方字节。这个变化针对入站,不能推断大响应也获准,也不能从内存规格推断上传吞吐量。
变量在设置它的部署环境内对整个项目生效,不是给一个路由单独放行。核心变化是启用后 Routing Middleware 仍会运行、仍能看到请求头和元数据,但不会收到请求体。即使请求只有一行 JSON 也一样。把 Edge 迁到 Node 或改用适合当前 Next.js 版本的 proxy.ts,可以改变运行时路径,但不等于恢复启用环境中的中间件正文读取能力。Preview 和 Production 可以分别配置,所以这个变更应先在独立的预览部署里验证,并把实际部署所用的变量和运行时写进验收记录。只看到控制台有一个变量,不算已经验证了被测部署实际采用哪条路径。
现实里最容易漏掉的是旧请求的默认分支。例如某条写接口原本用中间件解析正文中的工作区标识;正文不可读后,如果逻辑把这个情况当默认工作区,就可能出现跨工作区的数据归属错误。首先应把真正的身份和权限判断留在会执行操作的处理器中,以会话、经过验证的凭证和服务端保存的归属建立约束。然后盘点入口层哪些需求只看方法、路径、请求头和可信身份即可,哪些必须由终点读取正文。不能用一个由浏览器自由填写的工作区头当作授权证明。若确实要按正文内容分派,先走同一个明确入口,由它校验后进行内部业务分发,不让两层分别尝试消费同一个输入流。
三条路径先选一条,不要一起开大
第一条是 Node.js Route Handler 直接收文件。它适合上限明确、上传量可控、要求服务端在入口按实际字节施加限制的导入工具。浏览器直接发送 File 或 Blob,约定请求体就是原文件,不裹 multipart;后端读取分片,只看累计字节和受控的头部样本,再把合格内容交给受限制的保存或解析流程。这样不依赖中间件先解析一遍。限制并发和为慢客户端配置期限仍是应用工作;二十兆的平台许可不是让每个请求都占满内存的建议。没有队列或异步事务设计时,文件越大、连接越慢,请求越容易和页面接口争抢资源。
第二条是沿用 Next.js Server Action,适合小表单或小附件,不宜把环境开关当作它的配置项。Next.js 文档把默认请求体上限列为 1 MB,可通过 experimental.serverActions.bodySizeLimit 单独配置。
该限制应用于请求,不是文件选择器显示的文件大小;表单字段与分隔符也占用字节。同一份十兆文件从普通 Handler 可成功,从默认 Action 失败,这不是公测设置失效。反过来,把 Action 上限设得比平台接收范围更大,也不会说服入口代理放行。若业务只有小表单,保留原上限往往是更容易运营的选择,不应让所有表单都为一条导入路线承担更大的解析成本。
第三条是浏览器直传对象存储。用 Vercel Blob 的客户端上传作例子,应用函数处理的是上传令牌交换与完成通知,文件字节不通过该函数的入站请求体。它适合体积波动大、用户可能上传二十兆以上、或者需要与小接口隔离的场景。
这里并不是把权限外包给存储:发令牌之前要校验身份、待上传记录和目标路径,设置允许的类型和大小;不要把通用写入密钥送到浏览器。等对象到达后,按服务端记录校验归属、当前状态和内容,才把结果变成可用的导入批次。前端完成进度条不等于业务可用;回调可能重复,更新状态前应用唯一上传标识和状态条件,重复通知不应重复建立导入任务。
这三条不是互相替代的版本号。若原项目剩下的中间件无法在这次发布里拆掉,且上传业务很急,先用直传或隔离到另一个明确边界的部署,比打开环境开关再把旧路由逐个修好更稳。如果十兆是严格受控的内部导入,又希望尽快拒绝不合法样本,直接路由更简单;如果没有稳定的存储完成校验,不应因为直传可以绕开函数上限就升级它。
从一个只计数、绝不落库的探针开始
示例使用 Next.js App Router 的 Web Request 接口与 Node.js 运行时。建一个仅用于实验的 app/api/import-probe/route.js 文件,下面整段可以直接作为路由代码。用 Node 24 跑单元逻辑不需要第三方依赖。十二 MiB 是业务设定,为十兆样本留余量,并不复刻 Vercel 的阈值。示例允许恰好十二 MiB,把超出的第一个块拒绝;不使用 arrayBuffer() 把整个正文复制到应用内存。它不保存内容,不解析表格,不产生导入任务。部署到 Preview 前仍要确保探针只对测试人员可达,正式导入另行实现鉴权、存储、内容检查与审计。
export const runtime = 'nodejs';
const CAP = 12 * 1024 * 1024;
async function measure(body) {
if (!body) return { status: 400, code: 'MISSING_BODY' };
const reader = body.getReader();
let total = 0;
try {
for (;;) {
const { done, value } = await reader.read();
if (done) return total === 0
? { status: 400, code: 'EMPTY_BODY' }
: { status: 200, bytes: total };
total += value.byteLength;
if (total > CAP) {
await reader.cancel().catch(() => {});
return { status: 413, code: 'IMPORT_BODY_LIMIT' };
}
}
} catch {
return { status: 400, code: 'BODY_READ_FAILED' };
} finally {
reader.releaseLock();
}
}
export async function POST(request) {
const kind = request.headers.get('content-type')?.split(';')[0]?.trim();
if (kind !== 'application/octet-stream') {
return Response.json({ code: 'EXPECTED_RAW_UPLOAD' }, { status: 415 });
}
const { status, ...result } = await measure(request.body);
return Response.json(result, { status });
}
这里不信任 Content-Length 作为最终依据。生产代码可以用它提前拒绝已经声明过大的请求,不能仅凭缺失或较小声明就放行,也不能用浏览器 File 的大小替代服务端读出的实际字节。处理器按块计数,不保留已读的块;当超过业务线时尝试取消读取并释放锁。此举不能保证平台本身不曾缓冲数据,也不是带宽节省承诺。真实保存应让下游速度传回到读流循环,而不是每收到一个块就不受控制地启动写入。采用分片对象或暂存文件时,超限、读取失败、写入失败和超时都得终止暂存并安排清理。没有完整成功记录的对象不应进入读者可见位置;应用自己还要限制解析后体积、行数、单行长度和解压倍率,原始字节上限不足以覆盖这些维度。
下面给出生成和调用的命令。替换预览域名,使用零填充的合成数据,不发送生产客户文件。若预览有保护,用项目已有的授权方式访问;不能把一个公开无鉴权的上传入口作为上线探针。对于本地开发,把 BASE 改成本地地址即可;本地不会有公测入口上限和平台中间件变化,适合先看应用分支。
BASE=https://your-preview.example
node -e "require('node:fs').writeFileSync('ten.bin',Buffer.alloc(10*1024*1024))"
curl -sS -i -H 'Content-Type: application/octet-stream' \
--data-binary @ten.bin "$BASE/api/import-probe"
若请求到达启用环境里的探针,十 MiB 样本的预期响应是 200 和 {"bytes":10485760}。用同样方式生成十二 MiB 以及十二 MiB 加一字节,预期分别是成功与应用的 IMPORT_BODY_LIMIT。
十四 MiB 同样应被应用拒绝;二十 MiB 加一字节则应先被平台拦截,不期望自定义 JSON。发送 multipart/form-data 应得到 415,这是此探针公开的合约,不是 Next.js 不支持表单。真实界面可以在选文件时先提示业务上限,然后把原始 File 作为请求体发送;若网络中断,不要自动把页面状态标为导入失败或成功,应用应查询服务端记录后再决定是否重试。
我用 Node.js 24.22.3 对文中 measure 逻辑执行了六项断言:多块累计、缺失请求体、空流、边界值、超过一字节、以及流读取出错均通过。这里验证的是 Web Streams 的字节计数和返回分支,不是 Vercel、Next.js 路由、中间件、Blob 或真实网络的调用结果。上述 curl 及后面的 Preview 矩阵是供部署者复核的步骤,不代表已在平台上跑过。
验收时故意让三类拒绝各出现一次
先保留一份未开变量的基准 Preview,再给启用变量的 Preview 配成目标运行时和四 GB。两边用相同版本、相同路由和相同合成请求;记录部署标识、所选运行时、是否经过中间件和是否命中处理器。日志里只记录测试标识、长度和结果码,不复制请求体或认证头。用一个小的旧接口跨两边对照:如果正文相关规则在启用后移到了最终处理器,行为应仍一致;若不能一致,需要调整路由或撤回公测开关。相同的错误页面不足以分辨是代理还是应用,配合应用自定义错误码和是否出现入站日志定位。
再对同一个新 Preview 执行三个对照。原始 Handler 上发送十 MiB,验证大请求真正进了目标函数;同一个文件通过默认 Server Action,预期在框架自己的阈值被拒,且不应产生后台作业;另外保留一个 Edge 测试点,用略大于旧上限的合成数据确认该路径仍被平台拒绝。对于接近上限的表单,记录线上实际封装后的正文大小,而不是把文件大小抄进测试报告。
定位错误时优先看路由选择:函数接受新阈值并不保证前面仍走 Edge 的链路也接受。若应用主动拒绝的输入返回了平台的错误页,查看中间路径是否还有更低的限制;若直接把业务限额设成入口上限,就很难构造出可诊断的独立应用拒绝样本。
直传则用另一套断言。给合法测试用户发短时的受限令牌,验证上传完成前不建可见导入;回调重复时,状态只流转一次;文件或路径不属于原来那笔待上传记录时,不交给解析器。分开观察签发、对象写入、业务校验三条记录,中途出错时才能知道是重签发、等待回调,还是清理孤立对象。内部导入处理器也适用这个原则:可以把导入记录和排队请求一起可靠提交,再由后台解析,但不要从一次 HTTP 成功推断文件处理已经完成。
最后才决定是否把变量移到 Production。回退不仅是重发旧代码,还要恢复该环境的变量、内存和与之匹配的入口拓扑,并再跑一遍旧小请求。若启用期间已受理大文件,回退后仍应允许查询已存在的作业、让后台处理或明确终止;不应把它们变成客户端无从判断的失败。以每个环境的小路由功能、各层拒绝证据和失败清理作为上线条件,比只证明一次十兆上传成功更能防止这项配置波及不相关的接口。
评论
暂无评论。