applyToEither用于在两个异步任务中取最先完成的结果并立即处理，而非等待全部完成；典型误用是忽略异常导致链路崩溃，正确做法是为每个任务配置超时与降级兜底。

applyToEither 的作用和典型误用场景 applyToEither 不是“等所有任务完成再选一个”，而是“只要任意一个完成就立刻执行后续逻辑”。很多人以为它能自动兜底失败任务，其实它对异常完全不敏感——只要有一个 CompletableFuture 以异常结束，整个链路就会直接抛出 CompletionException，根本不会触发 applyToEither 的函数。 常见错误写法是把两个可能超时或报错的 HTTP 请求直接塞进 applyToEither，结果一上来就崩，连“最快响应”都等不到。

正确做法是：每个分支必须自己处理异常，确保至少有一个会正常完成。

如何让两个异步调用都具备“保底成功”能力 关键不是靠 applyToEither 做容错，而是让每个 CompletableFuture 自身可恢复：

• 用 orTimeout(3, TimeUnit.SECONDS) 主动设超时，避免卡死
• 用 exceptionally(ex -> fallbackValue) 把异常转成默认值（比如空对象、缓存值、降级响应）
• 避免在 supplyAsync 里直接 throw 检查型异常，改用 CompletableFuture.failedFuture() + exceptionally 统一收口

示例：

CompletableFuture<string> apiA = CompletableFuture.supplyAsync(() -> callExternalApi("A"))
    .orTimeout(2, TimeUnit.SECONDS)
    .exceptionally(ex -> "fallback-from-A");

CompletableFuture<string> apiB = CompletableFuture.supplyAsync(() -> callExternalApi("B"))
    .orTimeout(2, TimeUnit.SECONDS)
    .exceptionally(ex -> "fallback-from-B");

String fastest = apiA.applyToEither(apiB, s -> s).join(); // 取先完成的那个原始值
</string></string>

applyToEither 和 acceptEither 的选择依据 选哪个取决于你是否需要返回值：

• 要用结果做下一步计算（比如拼接、校验、写日志），用 applyToEither —— 它接收参数并返回新 CompletableFuture
• 只做副作用（比如记录耗时、发监控事件），用 acceptEither —— 它只消费值，不产生新 future
• 注意：applyToEither 的函数体里不要做阻塞操作，否则会拖慢整个链路；真要同步处理，用 thenApplyAsync

真实接口场景下容易被忽略的细节 微服务调用中，“最快”不等于“最可靠”。几个硬伤常被忽视：

• 网络抖动可能导致某个节点短暂延迟，但该节点本身健康——盲目切走会放大局部问题
• 两个请求如果共享下游依赖（比如同一个数据库连接池），快的那个可能只是运气好抢到了资源，不代表它更稳定
• applyToEither 不保证执行顺序，如果两个 future 几乎同时完成，JVM 线程调度可能让任意一个胜出，结果不可预测
• 别忘了关闭未完成的请求：HTTP 客户端（如 OkHttp）需手动 cancel，否则连接和线程会泄漏

真正落地时，往往得配合熔断器（如 Resilience4j）+ 请求取消 + 业务降级策略，applyToEither 只是其中一环。