AbortSignal.timeout() 仅提供基础超时控制,需手动组合熔断(状态机+失败计数+时间窗口)和自愈(半开探测+指数退避)能力,最终封装为按 key 隔离的 safeFetch 函数。

直接用 AbortSignal.timeout() 可以设置 fetch 请求超时,但它本身不提供熔断(circuit breaking)和自愈(recovery)能力——需要你手动组合重试、状态记录、退避策略和开关控制。
1. 用 AbortSignal.timeout() 实现基础超时控制
现代浏览器已原生支持 AbortSignal.timeout(ms),比手动 setTimeout + controller.abort() 更简洁安全:
- 它自动创建
AbortController并在指定毫秒后调用abort() - 不会因多次调用或 clearTimeout 遗漏导致内存泄漏
- 配合
fetch(..., { signal })即可中断请求
示例:
const res = await fetch('/api/data', {
signal: AbortSignal.timeout(5000) // 5 秒后自动 abort
});
若超时,会抛出 DOMException: The operation was aborted(name === 'AbortError'),可据此区分超时和其他错误。
2. 熔断器核心:状态机 + 失败计数 + 时间窗口
熔断不是“失败一次就关闸”,而是基于统计的动态开关。一个轻量实现需跟踪:
-
当前状态:
OPEN(拒绝新请求)、HALF_OPEN(试探性放行)、CLOSED(正常通行) - 失败计数:单位时间(如 60 秒)内连续失败次数
-
阈值:例如「60 秒内失败 ≥ 3 次」则跳转到
OPEN -
冷却时间:进入
OPEN后,等待固定时长(如 30 秒)才允许试探
无需第三方库,用一个闭包对象即可维护这些状态,注意用 Date.now() 做时间判断,避免依赖定时器精度。
3. 自愈机制:半开状态 + 指数退避重试
熔断器进入 OPEN 后不能永远拒绝——需在冷却期结束后主动发起一次探测请求(即进入 HALF_OPEN):
- 若探测成功,重置失败计数,切回
CLOSED - 若探测仍失败,延长冷却时间(如 ×1.5),并保持
OPEN - 对普通请求,在
OPEN状态下直接 reject(不发网络请求),节省资源
对于允许重试的业务请求,可在 CLOSED 或 HALF_OPEN 下叠加指数退避逻辑(如 100ms → 300ms → 900ms),但需限制最大重试次数(如 ≤ 2),避免雪崩。
4. 组装成可复用的 fetch 包装函数
把超时、熔断、重试三者融合,形成带策略的 safeFetch:
- 接收 URL、options,并支持传入
{ timeout: 5000, maxRetries: 2, circuitKey: 'user-api' }等策略 - 内部检查熔断器状态,
OPEN则同步 rejectnew Error('CIRCUIT_OPEN') - 实际 fetch 前合并 signal:
AbortSignal.any([controller.signal, AbortSignal.timeout(timeout)]) - 捕获
AbortError视为超时;其他网络/响应错误计入失败计数 - 仅当请求成功且处于
HALF_OPEN时,关闭熔断器
关键点:熔断器按 circuitKey 隔离(如不同接口独立熔断),避免一个接口故障拖垮全局。










