Promise.any返回首个成功resolve的Promise结果，全失败时抛AggregateError；适用于多备用服务取最快响应，需配合独立超时控制，不适用于需合并结果或串行回退场景。
Promise.any 适合在多个备用服务中“取第一个成功响应”，只要有一个 resolve 就立即返回结果，其余失败或未完成的会被静默忽略（不中断执行，也不抛错）。
基本用法：传入 Promise 数组，返回首个成功结果
它和 Promise.race 不同：race 对第一个 settle（无论 resolve 还是 reject）都响应；而 any 只关心第一个 resolve，所有 promise 都 reject 才会抛出 AggregateError。
示例：
const apiA = fetch('/service-a').then(r => r.json());
const apiB = fetch('/service-b').then(r => r.json());
const apiC = fetch('/service-c').then(r => r.json());
Promise.any([apiA, apiB, apiC])
.then(result => console.log('最快成功的数据:', result))
.catch(err => {
if (err instanceof AggregateError) {
console.error('所有备用服务都失败了', err.errors);
}
});
配合超时控制，避免某个服务卡死
真实场景中，个别服务可能响应极慢甚至挂起。建议给每个请求加 timeout，防止拖累整体响应速度。
立即学习“Java免费学习笔记（深入）”；
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 用
AbortController或封装带超时的 fetch - 每个 Promise 应独立超时，不能共用一个 signal
- 超时应以 reject 方式结束（否则
any会一直等）
简单 timeout 封装示例：
function timeoutFetch(url, ms = 5000) {
const controller = new AbortController();
const timeoutId = setTimeout(() => controller.abort(), ms);
return fetch(url, { signal: controller.signal })
.then(r => {
clearTimeout(timeoutId);
return r.json();
})
.catch(err => {
clearTimeout(timeoutId);
if (err.name === 'AbortError') throw new Error(`Timeout: ${url}`);
throw err;
});
}
Promise.any([
timeoutFetch('/primary'),
timeoutFetch('/backup-1'),
timeoutFetch('/backup-2', 3000)
]);
注意错误处理：AggregateError 是关键信号
当所有 Promise 都 reject 时，Promise.any 不会返回 undefined 或 null，而是抛出 AggregateError —— 它的 errors 属性是一个数组，包含所有 rejection 原因。
- 不要只用
catch(e => console.error(e))模糊处理 - 检查
e instanceof AggregateError来区分“全失败”和意外错误（比如传了非 Promise） - 可遍历
e.errors做日志、降级提示或触发告警
适用场景与限制
适合：多地域 API、主备服务切换、CDN 备选源、客户端特征探测（如多种权限检查）。
不适合：
- 需要所有结果做合并（该用
Promise.allSettled） - 要求严格按优先级顺序尝试（
any是并发发起，不是串行 fallback） - 部分失败需主动重试（
any不提供控制权，失败 Promise 无法再被监听）
