await promise.allsettled() 可并发执行所有任务并返回完整终态结果,避免串行低效与失败中断,适合需统计成功率、分类错误及混合处理的场景。

直接用 await Promise.allSettled() 就能拿到所有任务的终态结果,不丢数据、不断流程,适合需要完整统计成功率、失败原因或混合处理的场景。
为什么不能只用 await 逐个执行
连续写多个 await 是串行执行:前一个没结束,后一个根本不会发起。10 个接口每个耗时 1 秒,串行就要 10 秒;而 Promise.allSettled 让它们真正并发,总耗时接近最慢那个(比如 1.2 秒),效率差出近 10 倍。
- 串行写法:
const a = await fetch('/a'); const b = await fetch('/b');→ 实际是 a 完了再发 b - 并行写法:
const [a, b] = await Promise.all([fetch('/a'), fetch('/b')]);→ a 和 b 同时发出 -
allSettled是并行的升级版:即使 a 失败、b 超时,你依然能拿到两者的 status、value 或 reason
怎么组织 Promise 数组才不漏任务
动态列表(如 50 个用户 ID)要先用 map 构造全部 Promise,再传给 allSettled。别在循环里 await,也别提前 await 某个中间结果来生成数组。
- ✅ 正确:
const promises = userIds.map(id => api.getUser(id)); const results = await Promise.allSettled(promises); - ❌ 错误:
for (const id of userIds) { const res = await api.getUser(id); ... }→ 串行 - ❌ 危险:
const users = await Promise.all(userIds.map(id => api.getUser(id)));→ 一错全崩,失败项结果直接丢失
拿到 results 后怎么高效分类和统计
返回值是纯数组,每项带 status 字段,可直接用数组方法过滤、映射、判断:
- 取所有成功响应:
results.filter(r => r.status === 'fulfilled').map(r => r.value) - 收集全部错误原因:
results.filter(r => r.status === 'rejected').map(r => r.reason) - 统计成功率:
const successRate = results.filter(r => r.status === 'fulfilled').length / results.length - 检查是否至少有一个成功:
results.some(r => r.status === 'fulfilled') - 快速识别超时失败(假设 reason 是 Error 实例):
r.reason?.message.includes('timeout')
别忘了超时控制:allSettled 不会自动取消慢任务
Promise.allSettled 只等终态,不管多慢都等到最后。如果某请求卡住 30 秒,整个统计就得拖 30 秒。必须手动加超时。
- 用
AbortController配合 fetch:const controller = new AbortController(); setTimeout(() => controller.abort(), 8000); fetch(url, { signal: controller.signal }) - 通用超时包装函数:
const withTimeout = (promise, ms) => Promise.race([promise, new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), ms))]); - 然后这样用:
const promises = urls.map(u => withTimeout(fetch(u), 8000));











