Promise.race 本身不提供超时熔断，但可与定时拒绝 Promise 组合实现：将业务请求与超时 Promise 传入 race，谁先完成即返回其结果；超时则 reject 自定义错误，配合 AbortController 真正取消请求，并可扩展为带失败计数的熔断器。
Promise.race 本身不直接提供“超时熔断”，但它可以和 Promise 组合，快速响应第一个完成（无论成功或失败）的异步操作，从而实现简易的超时控制——本质是用一个“定时拒绝”的 Promise 和业务请求 Promise 赛跑。
用 Promise.race 包装单个接口请求 + 超时
核心思路：把真实请求和一个 setTimeout 拒绝的 Promise 一起传给 Promise.race。谁先结束，就以它的结果为准。
- 如果接口在超时前返回，
race返回其成功结果 - 如果超时先触发，
race立即 reject 一个自定义错误（如'Request timeout'），后续可捕获做熔断处理
示例代码：
function fetchWithTimeout(url, timeout = 5000) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), timeout);
return Promise.race([
fetch(url, { signal: controller.signal })
.finally(() => clearTimeout(timeoutId)),
new Promise((_, reject) =>
setTimeout(() => reject(new Error('Request timeout')), timeout)
)
]);
}
// 使用
fetchWithTimeout('/api/user')
.then(res => res.json())
.catch(err => {
if (err.message === 'Request timeout') {
console.log('触发超时熔断');
// 可在此上报、降级、返回默认数据等
}
});
多个接口并行请求 + 全局超时熔断
当需要同时发起多个请求（如获取用户、订单、配置），但要求整体不能超过某一时限（比如 3 秒），可用 Promise.race 包裹整个 Promise.all。
立即学习“Java免费学习笔记（深入）”；
-
Promise.all([p1, p2, p3])等待全部成功；它本身是一个 Promise - 再用
Promise.race([allPromise, timeoutPromise])控制整体时限 - 任意一个失败（包括超时）都会导致 race reject，中断所有未完成请求（配合 AbortSignal 更干净）
示例：
async function fetchAllWithTimeout(urls, timeout = 3000) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), timeout);
try {
const results = await Promise.race([
Promise.all(
urls.map(url =>
fetch(url, { signal: controller.signal }).then(r => r.json())
)
),
new Promise((_, reject) =>
setTimeout(() => reject(new Error('All requests timeout')), timeout)
)
]);
clearTimeout(timeoutId);
return results;
} catch (err) {
clearTimeout(timeoutId);
throw err; // 可能是网络错误、abort 或 timeout 错误
}
}
注意点：AbortController 是更优的取消方式
Promise.race 只能“提前结束等待”，但无法真正取消已在执行的 fetch/XHR。若不加控制，超时后请求仍在后台运行，浪费资源。
- 务必搭配
AbortController（现代 fetch 支持signal） - 旧环境（如无 AbortController）可用
Promise.reject+ 标记位模拟取消逻辑（但无法终止底层请求） - 超时错误应区分于业务错误（如 404、500），便于统一熔断策略（如重试次数、降级开关）
进阶：简单熔断器封装（带失败计数）
真正的熔断需状态管理（如连续失败 3 次，开启熔断，暂停请求 30 秒）。Promise.race 只负责超时，熔断逻辑需额外维护状态：
- 用闭包或 class 记录最近失败次数和上次失败时间
- 每次请求前检查是否处于熔断期，是则直接 reject 或返回缓存
- 超时失败也计入熔断统计（因为可能是服务不可用）
- 恢复期可采用半开模式：定时尝试一次，成功则重置，失败则延长熔断
这不是 race 的职责，但它提供的快速失败能力，是构建该机制的关键一环。
