跳到主要内容
api工厂
JavaScript

Promise 并发模式全解:all / allSettled / race / any 与并发数控制

api工厂资讯栏目 约 7 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。

结论先行:Promise.all 要「全成功」、allSettled 要「全结果」、race 要「第一个落定」、any 要「第一个成功」,四个组合子语义各不相同,选错就是线上事故。而真实业务更常见的需求是「限制并发数」,标准库没有现成答案,需要一个二十行左右的并发池。本文把四种组合子的边界行为讲透,并给出可直接复用的手写并发池与超时重试封装。

四个组合子的语义速查

方法成功条件失败行为典型场景
all全部 fulfilled任一 rejected 立即 reject页面初始化依赖的多接口
allSettled永远成功逐个记录 status/reason批量操作后统一汇报
race第一个落定(无论成败)第一个落定是失败就失败超时控制、多源竞速
any第一个 fulfilled全部失败才 reject(AggregateError)多 CDN 容灾取最快可用

两个高频误区:第一,all 的 fail-fast 只是「不再等待」,已经发出的请求不会被取消,想真正中止要配合 AbortController;第二,race 拿到的是「最先落定」而不是「最先成功」,用它做容灾时一个快速失败会拖垮整体,容灾应该用 any。

js
const results = await Promise.allSettled([saveA(), saveB(), saveC()]);
const failed = results.filter((r) => r.status === 'rejected');
console.log('失败数:', failed.length);

const fastest = await Promise.any([cdn1(), cdn2(), cdn3()]);

any 全失败时抛出 AggregateError,errors 数组里按输入顺序收集每个原因,排查时记得展开它而不是只看 message。

为什么需要并发数控制

Promise.all 一次性发起全部任务:一千张图同时下载会打满浏览器连接数、触发服务端限流,甚至把低端设备内存撑爆。分批串行(每批 10 个 await 一次)又太粗糙——批内最慢的任务会拖住整批。正确模型是「滑动窗口」:始终维持 N 个在途任务,完成一个立刻补一个。

手写并发池:二十行核心实现

js
async function pool(tasks, limit) {
  const results = new Array(tasks.length);
  let next = 0;
  async function worker() {
    while (next < tasks.length) {
      const i = next++;
      try {
        results[i] = { status: 'fulfilled', value: await tasks[i]() };
      } catch (reason) {
        results[i] = { status: 'rejected', reason };
      }
    }
  }
  await Promise.all(
    Array.from({ length: Math.min(limit, tasks.length) }, worker)
  );
  return results;
}

要点有三个:tasks 必须是「函数数组」而不是 Promise 数组,否则任务在传入前就已全部启动,限流失效;next++ 在单线程事件循环里是原子的,不需要锁;结果按原始下标存放,顺序与输入一致。返回结构对齐 allSettled,调用方可以统一处理成败。

js
const tasks = urls.map((u) => () => fetch(u).then((r) => r.json()));
const results = await pool(tasks, 6);

超时与重试:组合子的实战拼装

race 最经典的用法是给任意 Promise 加超时:

js
function withTimeout(promise, ms) {
  const timer = new Promise((_, reject) =>
    setTimeout(() => reject(new Error('timeout')), ms)
  );
  return Promise.race([promise, timer]);
}

注意超时后原任务仍在跑,fetch 场景应改用 AbortSignal.timeout(ms) 真正中止请求。重试则用循环加指数退避,配合 any 还能做「主备双发取先成功」的激进容灾,但要评估服务端压力。

结合业务:批量拉取接口数据的正确姿势

商城首页常要并发拉 Banner、分类、推荐商品等多个接口。用 api工厂(https://www.it120.cc/)的 SDK 时,初始化依赖用 all,批量补全商品详情用并发池:

js
import WXAPI from 'apifm-wxapi';
WXAPI.init('your-subdomain');

const [banner, cats] = await Promise.all([
  WXAPI.banners({ key: 'index' }),
  WXAPI.goodsCategory(0),
]);

const tasks = ids.map((id) => () => WXAPI.goodsDetail(id));
const details = await pool(tasks, 5);
const ok = details.filter((r) => r.status === 'fulfilled').map((r) => r.value.data);

SDK 方法统一返回 Promise、{code,data,msg} 中 code==0 为成功,业务失败(如商品下架)不会走 catch,记得在池外再按 code 过滤一层。接口清单见 SDK 文档(https://www.it120.cc/sdk/index.html),也可以先在 Playground(https://www.it120.cc/playground.html)里验证参数。

小结

选组合子先问「我要全成功、全结果、第一个落定还是第一个成功」;批量任务一律走并发池而不是裸 all;超时用 AbortSignal 而不是裸 race。把这三条变成团队约定,异步代码的事故率会显著下降。

文章标签

JavaScriptPromise并发控制async/await异步编程

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。