CompletableFuture.allOf仅等待所有任务完成而不返回结果，需配合原始引用逐个join获取值并暴露异常。
CompletableFuture.allOf 不会返回结果，直接用它拿不到任何任务的返回值——这是绝大多数人踩的第一个坑。
为什么 allOf 拿不到每个任务的返回值
allOf 的设计目标只有一个：等待所有任务完成（不管成功或失败），返回一个 CompletableFuture<void></void>。它不聚合结果，也不处理异常传播，本质是个“同步栅栏”。
- 如果你传入的是
CompletableFuture<string></string>、CompletableFuture<integer></integer>等带泛型的任务，allOf会把它们全部擦除成CompletableFuture>，最终只关心“是否结束” - 想拿到结果？必须额外保存引用，或者改用
allOf+join()手动取值 - 一旦某个任务抛出异常，
allOf返回的 future 仍可能正常完成（除非你显式调用join()或get()）——异常被“吞掉”了
怎么安全地并行执行并收集所有结果
正确做法是：先用 allOf 等待完成，再通过原始 CompletableFuture 引用逐个 join() 取值。别试图从 allOf 的返回值里“解包”。
- 把每个任务存进一个
List<completablefuture>></completablefuture>，别丢引用 - 调用
CompletableFuture.allOf(futures.toArray(new CompletableFuture[0])) - 紧接着
allOf(...).join()确保全部完成 - 再遍历原始 list，对每个 future 调用
join()获取结果（此时才真正触发异常）
示例：
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
List<CompletableFuture<String>> futures = Arrays.asList(
CompletableFuture.supplyAsync(() -> "a"),
CompletableFuture.supplyAsync(() -> "b"),
CompletableFuture.supplyAsync(() -> { throw new RuntimeException("boom"); })
);
CompletableFuture.allOf(futures.toArray(new CompletableFuture[0])).join(); // 等待全部结束
List<String> results = futures.stream()
.map(CompletableFuture::join) // 这里才会抛出 RuntimeException
.collect(Collectors.toList());
allOf 遇到异常时的行为和修复方式
allOf 本身不传播异常；它完成时状态是正常的，哪怕子任务已失败。只有当你对某个失败的 CompletableFuture 调用 join() 或 get()，才会暴露异常。
- 常见错误：只调用
allOf(...).join()就认为“全部成功”，结果后续取值时才崩 - 如果需要任一失败就中断汇总，得自己检查每个 future 的
isCompletedExceptionally() - 不想手动遍历？可以封装工具方法，在
allOf后统一join并捕获第一个异常，或用handle做兜底
替代方案：什么时候该用 allOf，什么时候该换别的
如果你真需要“等全部完成 + 拿全部结果 + 统一异常处理”，allOf 是半截工具——它只干了前1/3。
- 要结果聚合且类型一致：优先考虑
CompletableFuture.allOf+ 手动join，或用第三方库如CompletableFutures.allAsList（Guava） - 要任意失败立即停止：不用
allOf，改用anyOf+ cancel 其他，或用thenCombine链式串接（牺牲并行性） - 要带超时控制：不能只给
allOf(...).get(5, TimeUnit.SECONDS)，因为子任务还在跑；得用orTimeout分别加在每个 future 上
真正难的不是写对语法，而是想清楚：你到底要“等完成”，还是要“等成功”，还是“等结果+容错”。allOf 只承诺前者，其余都得自己补。
