如何基于 AbortSignal.timeout 为原生 fetch 请求建立秒级自动熔断降级机制-js教程-PHP中文网

abortsignal.timeout 本身不是熔断器，因为它仅提供单次超时中断能力，无状态、不累计失败、不封禁后续请求、无半开/降级逻辑，无法实现熔断所需的错误统计、状态切换与fallback机制。

如何基于 abortsignal.timeout 为原生 fetch 请求建立秒级自动熔断降级机制

AbortSignal.timeout 能直接给 fetch 加秒级超时，但不能单独实现“熔断降级”——它只管中断，不记失败次数、不封禁后续请求、也不提供 fallback 逻辑。

AbortSignal.timeout 是一个生成带超时的 AbortSignal 的静态方法，用在 fetch 的 signal 选项里可让请求在指定毫秒后自动 abort。但它：

真正可用的秒级熔断，需要在 fetch 外包一层带状态的记忆逻辑。关键不是替换 fetch，而是控制它的调用时机和 fallback 路径：

维护一个全局或 per-endpoint 的 isCircuitOpen 标志 + failCount 计数器
每次请求前检查：若熔断开启且未到恢复时间，直接跳过 fetch，走降级逻辑（如返回缓存、默认值、空数组）
请求发起时传入 AbortSignal.timeout(3000)，捕获 AbortError 和网络异常（如 TypeError: failed to fetch）统一计入失败
连续失败达到阈值（如 3 次），设 isCircuitOpen = true，并记录 openUntil = Date.now() + 30_000
后续请求若 Date.now() > openUntil，自动进入“半开”，允许一次试探请求；成功则关闭熔断，失败则延长 openUntil

示例核心判断逻辑：

if (isCircuitOpen && Date.now() 

<h3>常见踩坑点：AbortError 误判与信号复用</h3>
<p>实际写的时候容易在错误处理和信号生命周期上翻车：</p>

AbortError 不是 fetch 抛出的唯一异常，TypeError（DNS 失败、CORS）、NetworkError（Chrome 120+）也常见，需统一 catch 并归为“下游故障”
不要复用同一个 AbortSignal 实例多次传给不同 fetch——signal 一旦 abort 就不可重用，重复使用会立即 reject
AbortSignal.timeout 在 Safari 17.4+ 和 Firefox 119+ 才支持，旧版需回退到 AbortController + setTimeout 手动 abort
如果请求本身已 resolve（比如服务端快速返回 200），但之后才触发 timeout，不会造成影响；但若响应流式返回中 timeout 触发，可能中断读取，需在 response.body.getReader() 层再加保护