侧边栏壁纸
博主头像
一笑痕

人生若只如初见,
是可喜亦或者是可悲?

  • 累计撰写 297 篇文章
  • 累计收到 7 条评论

fetch 发出 Request 后,原请求体不能再读

2026-11-21 / 0 评论 / 9 阅读

fetch 发出 Request 后,原请求体不能再读

把一个 Request 传给 fetch() 发出后,再调用 request.text(),Node 会抛 TypeError。请求已经成功到达服务端,响应也是 200,失败发生在本地第二次读请求体时。调试代码若在发送后才想记录原始正文,正好会撞上这个边界。

发送动作会消费请求体

Fetch 的请求体是可读流,不是可重复读取的字符串字段。请求体开始被读取后,bodyUsed 会变成 true。传给 fetch() 的 Request 会作为发送输入;发送结束后,同一个对象不再能用 text()、json() 或 formData() 重新解析。

用本机 Node v26.8.1 起了一个回环 HTTP 服务,客户端把带 JSON 正文的 Request 交给 fetch()。服务端实际收到了 POST 和正文,响应返回 200;随后再读原请求,就得到 TypeError。验证脚本和原始日志分别在 tools/verify-fullstack-fetch-request-body-used-20261121.mjs、tools/verify-fullstack-fetch-request-body-used-20261121.log。

runtime: v26.8.1
server: POST /submit received 27 bytes: {"order":42,"note":"draft"}
fetch response: 200 accepted
original.bodyUsed after fetch: true
read original again: TypeError: Body is unusable: Body has already been read
clone made before fetch: bodyUsed=true, same body=true
clone after body read: TypeError: unusable
assertion: PASS

这里的 bodyUsed=true 是已经消费的标记,不表示服务端处理成功,也不说明响应正文的状态。脚本把请求发到了真实的本机 HTTP 端口,断言服务端收到的方法和完整正文,再检查客户端对象的状态。它验证的是 Node 内置 Fetch,不覆盖浏览器内部实现或第三方 HTTP 客户端。

clone 要赶在消费之前

需要发送后仍保留一份可读请求时,可以先克隆:

const request = new Request(url, {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ order: 42, note: 'draft' }),
});
const copy = request.clone();

const response = await fetch(request);
const responseText = await response.text();
const savedBody = await copy.text();

本机脚本先创建 copy,再把原对象交给 fetch()。发送之后,原对象的 bodyUsed 是 true;副本仍可读取,取出的字符串与发出的 JSON 一致。副本本身读完后也会变成已消费状态。

顺序不能反过来。若先调用 await request.text(),再执行 request.clone(),Node 会报 TypeError: unusable。克隆不会恢复已经读完的流;它要在第一次读取前创建,才能另保留一条可消费路径。Fetch 的克隆会分出两个读取分支,调用方分别读取同一份正文。两个分支不一定同速,若一边迟迟不读,缓存压力就会留在流处理链路里。小 JSON 看不出差别,大上传或长时间响应就不该把副本当成零成本备份。

日志和重试别临时再读

常见的误用是把 Request 当成普通对象,在发出后才交给日志函数解析正文。日志函数读到的是已消费流,不是原始 JSON。bodyUsed 只回答「这条请求体流是否已经被消费」,不表示服务器已经确认事务,也不表示客户端收到了响应正文。若要把发送记录和响应结果配对,可以给两边记同一个请求标识,再单独保存响应状态;别把读取请求体当成状态确认。

若确实需要审计字段,可以在发送前解析并保存经过筛选的值,避免把密码、令牌或个人信息写进日志。需要留整份原文时,也应先明确存储方式和保留期限。对 multipart 上传,额外读取还会涉及文件内容,通常更适合在生成请求时记录文件元信息和业务编号,而不是复制整个上传体。

重试也要区分请求与请求体。保留一个已用过的 Request,不代表可以把它再交给 fetch() 一遍。重试时应根据原始数据重新构造请求,或在首次发送前准备可用副本,并确认服务端操作具有幂等保护。网络错误不总能说明服务端没处理请求,盲目重放 POST 可能重复创建记录。

这次我只验证了小型 JSON 正文在 Node Fetch 下的行为,没有测大文件流的内存占用。业务只需发送一次时,直接传请求就好;发送后还要检查正文,先 clone 或保留经过最小化处理的数据。请求体是流,读取次数要在代码里安排好。

    🤞 分享