CompletableFuture.anyOf用于获取多个异步任务中第一个完成的结果，返回Object类型，需手动强转且不区分成功或异常；适合简单快速响应场景，但生产环境推荐applyToEither或自定义首个成功逻辑。
Java 中没有直接叫 anyOf 的标准 API，但可以通过 CompletableFuture.anyOf 实现“获取多个异步任务中第一个完成的结果”这一需求。
✅ 使用 CompletableFuture.anyOf 获取首个完成结果
CompletableFuture.anyOf 接收一个 CompletableFuture>... 可变参数，返回一个新的 CompletableFuture<object></object>，它会在**任意一个入参 future 完成（正常结束或异常）时立即完成**，其结果是该完成 future 的结果（注意：类型为 Object，需手动强转）。
⚠️ 注意：它不区分成功/失败——只要有一个完成（哪怕是抛异常），就立刻结束并返回那个结果（包括异常）。
示例：
立即学习“Java免费学习笔记（深入）”；
CompletableFuture<String> task1 = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(2000); } catch (InterruptedException e) {}
return "result-1";
});
CompletableFuture<Integer> task2 = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(500); } catch (InterruptedException e) {}
return 42;
});
CompletableFuture<Boolean> task3 = CompletableFuture.supplyAsync(() -> {
try { Thread.sleep(1000); } catch (InterruptedException e) {}
return true;
});
// 等待任一任务完成
CompletableFuture<Object> first = CompletableFuture.anyOf(task1, task2, task3);
Object result = first.join(); // 得到 42（因为 task2 最快）
// 需要自己判断类型并转换（不安全，慎用）
if (result instanceof Integer) {
System.out.println("First result: " + (Integer) result);
}
⚠️ anyOf 的局限性与常见坑
-
返回类型是 Object：丢失泛型信息，无法直接获得原始类型（如
String或Integer），需运行时类型检查和强制转换，容易出ClassCastException。 -
不区分完成状态：如果最快完成的是一个
exceptionally的 future，anyOf也会立即返回该异常，调用join()会直接抛出。 - 无法得知是哪个任务胜出：只知道结果值，但不知道它来自 task1、task2 还是 task3。
-
不支持泛型推导：不能像
allOf那样组合后统一处理；也没有内置的“只等成功结果”的变体。
? 更安全实用的替代方案
若你真正想要的是“**等待第一个成功完成的任务结果（忽略失败）**”，推荐以下方式：
-
用
applyToEither两两组合：适合只有两个任务，清晰且类型安全。task1.applyToEither(task2, s -> s)—— 返回最先成功完成的String。 -
封装工具方法，过滤异常：对每个 future 调用
exceptionally(e -> null)，再用anyOf，最后过滤掉null结果。 -
使用第三方库（如 Vavr / Cyclops）：提供
Future.firstOf(...)等更语义化、类型安全的 API。 -
手动轮询 + completeOnSuccess（高级）：创建一个新
CompletableFuture，为每个任务注册whenComplete回调，首次遇到非异常结果就complete它——完全可控、类型安全、可记录来源。
? 小结：何时用 anyOf？
它适合场景简单、能接受 Object 类型、且对失败不敏感的快速响应逻辑（例如：发起多个降级请求，取任意一个返回即可）。生产环境若需健壮性、可维护性和类型安全，建议优先采用 applyToEither（双任务）或自定义“首个成功”逻辑。
