JavaScript Promise.any 怎样获取第一个成功结果

当页面需要从多个接口、缓存层或备用资源中先拿到一个可用结果时，Promise.any() 是最直接的选择：它等待输入中第一个 fulfilled 的 Promise，并把那个成功值交给调用方；先 reject 的候选不会让整体立即失败。要注意，所有候选都失败时才会进入 AggregateError，而已经发出的其他任务也不会因为某个结果先返回就自动取消。

const value = await Promise.any(candidates) 就能拿到第一个 fulfilled 值；若没有任何候选成功，再在 catch 中处理 AggregateError。

把候选请求交给 Promise.any

调用方式是把一组 Promise 或 thenable 放入 iterable。数组位置只决定输入顺序，不决定哪个值获胜；真正决定结果的是哪个 Promise 先 fulfilled。下面用三个延迟不同的候选模拟多源读取：

function delayedValue(value, delay, shouldFail = false) {
  return new Promise((resolve, reject) => {
    // 用延迟模拟不同数据源的响应速度，失败候选只影响自己的状态。
    setTimeout(() => {
      if (shouldFail) {
        reject(new Error(`${value} 暂不可用`));
        return;
      }
      resolve(value);
    }, delay);
  });
}

async function pickFirstSuccess() {
  const candidates = [
    delayedValue("主接口", 180, true),
    delayedValue("边缘缓存", 80),
    delayedValue("备用接口", 240),
  ];

  try {
    // Promise.any 只接收首个 fulfilled 值，不等待数组中的所有成功结果。
    const value = await Promise.any(candidates);
    return value;
  } catch (error) {
    // 只有全部候选失败时才会走这里；保留原始错误供上层记录。
    throw error;
  }
}

pickFirstSuccess().then((value) => {
  console.log(value); // 边缘缓存
});

这个例子里“主接口”先失败，“边缘缓存”随后成功，所以结果是“边缘缓存”。即使“备用接口”仍在等待，组合 Promise 也已经 fulfilled。真实项目中可以把 fetch()、缓存读取函数或其他异步封装直接放进 candidates，但要保证每个候选在失败时真正 reject，而不是用一个错误对象 fulfilled，否则它会被当成成功值。

全部失败时用 AggregateError 找原因

如果所有输入都 reject，Promise.any() 才会拒绝。捕获对象是 AggregateError，其中的 errors 数组按传入 Promise 的顺序保存原因，而不是按实际完成的先后排列。这个特性适合把每个来源的失败信息映射回来源名称：

async function readFromFallbacks() {
  const names = ["主接口", "边缘缓存", "备用接口"];
  const candidates = names.map((name, index) => {
    return Promise.reject(new Error(`${name} 返回失败码 ${500 + index}`));
  });

  try {
    // 三个输入全部 reject，Promise.any 才会抛出 AggregateError。
    return await Promise.any(candidates);
  } catch (error) {
    if (error instanceof AggregateError) {
      // errors 与 names 同序，可稳定生成逐来源的诊断信息。
      return error.errors.map((reason, index) => ({
        source: names[index],
        message: reason.message,
      }));
    }
    throw error;
  }
}

不要只把 AggregateError 转成一句“全部失败”。生产日志至少应保留来源名和错误原因；如果传入空数组，也会走失败分支，因此在构造候选列表前可以先判断是否为空，并给调用方一个更明确的业务提示。

Promise.any、Promise.race 与 Promise.all 怎么选

如果“第一个返回的结果”可能是失败，选 race；如果必须拿齐所有数据，选 all。如果只关心任意一个成功来源，才用 any。另外，any fulfilled 后，剩余请求仍可能消耗网络和服务端资源，需要取消时要把 AbortController 设计进每个候选任务，并在业务层决定何时调用 abort()。

常见问题

Promise.any 会返回数组中第一个 Promise 吗？

不会。数组位置只用于建立输入顺序；返回的是运行过程中第一个 fulfilled 的值。

有一个 Promise reject 会导致 Promise.any 失败吗？

不会。只要仍有候选最终 fulfilled，先发生的 reject 就会被忽略；只有全部候选 reject 才失败。

Promise.any 成功后会自动停止其他请求吗？

不会。它只结束组合结果，不会取消底层操作；需要节省资源时应额外设计取消信号。