
接口已经回了 200,页面接着执行 await response.text() 却抛出 TimeoutError。这不矛盾。fetch() 的 Promise 在响应头可用时就能兑现,正文是后续读取的流;如果超时信号还在生效,读取正文也会被中止。只在调用 fetch() 的那一刻检查异常,会漏掉这段更晚结束的工作。
为什么拿到 200 还会失败?
fetch() 返回的 Response 表示响应状态和头部已可用,不代表响应体全部抵达。正文可以很大,也可以由服务端分段发送。调用 text() 或 json() 时,客户端仍在消费同一条响应。
本机验证脚本 tools/verify-fetch-abort.mjs 有一条慢正文路径:服务端在 50ms 左右发响应头和第一个片段,等到 700ms 才结束正文。客户端给 fetch() 传入 300ms 的 AbortSignal.timeout(),拿到响应后立刻调用 response.text()。这次输出是:
[+ 650ms] === 7. 响应头先到、body 很慢,AbortSignal.timeout(300) 管不管 body ===
[+ 719ms] 耗时 69ms 拿到响应头 status=200,接着读 body…
[+ 954ms] 读 body 抛错(耗时 304ms){"constructor":"DOMException","name":"TimeoutError","isDOMException":true,"isError":true,"message":"The operation was aborted due to timeout"}
这里的响应头大约在 70ms 到达,约 300ms 后读取正文失败。前者是从发出请求到收到响应头的时间,后者是从调用 fetch() 到读取正文失败的总时间。两者都早于服务端设定的正文完成时间。关键不在状态码,而在读取正文时 signal 已经触发。
超时计时从哪一刻开始?
AbortSignal.timeout(300) 的时钟从创建 signal 时开始走,不会等到 fetch() 被调用才启动。比如先创建 signal,再做一段耗时操作,真正请求能使用的时间就会缩短。脚本里另一个用例创建 200ms 的 signal,等待 150ms 才发请求,结果请求只存活约 50ms 就抛出 TimeoutError。
因此,若调用方把响应头视为成功并提前清理超时器,正文读取就失去这道上限;反过来,超时应覆盖到需要的数据已经读完为止。脚本的 fetchJson 封装把 fetch() 与 response.text() 放在同一个 try 里,成功结果是在正文完成后才返回。这种边界更接近应用真正需要的数据,而不是网络状态行已经到达。
服务端能看到哪一边断了?
输出不只看调用端异常。服务端监听了 req.aborted 与响应的 close 事件。慢正文那条记录为:
651ms request 到达 /slowbody-7
651ms req.aborted /slow-5b 客户端断开连接
651ms res.close /slow-5b 客户端提前走了
955ms request 到达 /fast-8
956ms res.close /fast-8 服务端写完了
956ms req.aborted /slowbody-7 客户端断开连接
956ms res.close /slowbody-7 客户端提前走了
请求在本轮输出的 651ms 左右到达服务端;约 300ms 后,客户端中止正文读取,服务端记录连接提前关闭。这里对应同一个本机 HTTP 请求,不是只从 TimeoutError 推测网络已经断开。换一套客户端或服务端框架,事件名字与通知时机可能不同,这份结果只覆盖当前 Node 环境。
Promise.race 能替代这个 signal 吗?
不能。脚本还将慢请求与 150ms 定时器放进 Promise.race()。调用端先拿到定时器结果,但服务端随后仍写完了响应。竞速只决定哪个 Promise 的结果先交出去,不会自动取消另一个请求。
要让请求可取消,必须把 AbortSignal 传给 fetch()。若接口调用还要读正文,读取也应留在同一取消范围里。已经拿到响应头就解除超时,会把慢正文留在没有期限的等待中;而只用 Promise.race,则连底层请求也不会因为调用方停止等待而自动结束。
我会把「完成」定义为正文读取结束,而不是拿到响应对象。实际业务若只需要状态码或少量头信息,可以在确认不再读 body 后结束这条链路;需要 JSON 内容时,则让超时信号覆盖 response.json()。本机测到的是 Node 内置 Fetch 与本地服务之间的行为。真实浏览器版本和代理转发没有覆盖;服务端业务回滚也不在这次验证范围内,不能从这份日志推断。