allof 返回 completablefuture，仅表示所有任务完成，不聚合结果；需保留原始 completablefuture 引用，逐一调用 join() 获取各值并处理异常。
allOf 返回的是 CompletableFuture，不是结果集合
这是最容易踩的坑：直接用 CompletableFuture.allOf() 等待所有任务完成，但它的返回值不包含任何业务结果——它只保证“都跑完了”，不负责“把结果收回来”。如果你写了 allOf(...).join() 就停在那里，后续根本拿不到各服务返回的 Response 或 DTO。
正确做法是：先用独立的 CompletableFuture 拿到每个接口的结果，再用 allOf 协调完成时机，最后通过原始的 future 实例分别 join() 或 get() 取值。
- 每个微服务调用单独封装成一个
CompletableFuture<response></response>，比如callUserService()、callOrderService() - 把它们放进数组或列表，传给
CompletableFuture.allOf() -
allOf后必须手动对每个原始 future 调用join()（推荐）或get()，不能依赖allOf的返回值
异常处理必须在每个子 future 里做，allOf 不会传播异常
CompletableFuture.allOf() 在任意一个子 future 抛出异常时，不会中断执行，也不会把异常抛出来——它可能静默失败，或者等到你调用某个子 future 的 join() 时才爆出来。线上环境容易误判为“没超时、没报错、但数据丢了”。
所以每个微服务调用都要配 handle() 或 exceptionally()，至少兜底返回空对象或默认值，避免整个汇聚流程因单点异常而卡死。
- 不要写
CompletableFuture.supplyAsync(() -> httpCall()).join()这种裸调用 - 改用
supplyAsync(...).handle((res, ex) -> ex != null ? fallback() : res) - 如果业务允许部分失败，最终汇聚时检查每个结果是否为 null 或标记为失败状态
别在 allOf 后直接 map 或 thenApply，它没有泛型参数
CompletableFuture.allOf() 的签名是 allOf(CompletableFuture>... cfs)，返回值是 CompletableFuture<void></void>。这意味着你不能对它链式调用 thenApply(list -> ...)——编译不过，IDE 会提示 “cannot resolve method thenApply”。
想做结果组装，有两个干净做法：
- 用
allOf(f1, f2, f3).thenRun(() -> { r1 = f1.join(); r2 = f2.join(); r3 = f3.join(); return assemble(r1,r2,r3); })，注意thenRun是无参无返回的，得在闭包里手动取值 - 更推荐：用
CompletableFuture.allOf(...).thenCompose(v -> CompletableFuture.completedFuture(assemble(f1.join(), f2.join(), f3.join())))，靠completedFuture把结果重新包成 future
超时控制要分别设，allOf 本身不支持统一 timeout
allOf 没有内置超时参数。如果你只对 allOf(...).get(5, TimeUnit.SECONDS) 加超时，那只是限制“等待全部完成”的时间，不等于每个接口都有 5 秒；某个慢接口拖了 8 秒，但其他 4 个早已完成，你却因为 get() 超时直接失败，浪费了已就绪的结果。
真实场景中，每个微服务的 SLA 不同，应单独设置超时，并用 orTimeout()（Java 9+）或 completeOnTimeout() 做兜底：
callUserService().orTimeout(2, TimeUnit.SECONDS).exceptionally(ex -> defaultUser())callOrderService().orTimeout(3, TimeUnit.SECONDS).exceptionally(ex -> emptyOrders())- 再把它们丢进
allOf，整体逻辑才真正可控
多个微服务并行汇聚的关键，不在 allOf 本身，而在你怎么组织那堆独立的 future——它们是否各自健壮、是否带超时、是否处理异常、是否方便后续取值。allOf 只是个协调者，不是搬运工。
