thenCombine用于并行执行两个独立异步任务并合并结果，要求两者均完成后由BiFunction生成新结果；默认在任一任务完成线程上执行，异常时短路，需配合exceptionally或handle兜底。
thenCombine 用于合并两个已完成的 CompletableFuture的结果，它要求两个任务都执行完毕后，用一个 BiFunction 将它们的结果组合成新结果。关键点是：两个任务可以并行执行、互不依赖，但 thenCombine 的回调只在两者都完成时才触发。
基本用法：合并两个异步任务的结果
假设你有两个独立的异步操作（比如查用户信息 + 查订单信息），想把它们的结果拼成一个对象：
CompletableFuture<User> userFuture = CompletableFuture.supplyAsync(() -> fetchUser(123));
CompletableFuture<Order> orderFuture = CompletableFuture.supplyAsync(() -> fetchOrder(456));
CompletableFuture<UserOrderSummary> summaryFuture = userFuture
.thenCombine(orderFuture, (user, order) -> new UserOrderSummary(user, order));
注意：thenCombine 不会阻塞主线程，返回的新 CompletableFuture 在两个前置任务都完成后自动完成。
执行时机与线程模型
默认情况下，thenCombine 的组合逻辑运行在任意一个前置任务完成时所在线程上（通常是较快完成的那个任务的线程），不是调用线程，也不是固定线程池。如果需要控制线程，应使用 thenCombineAsync：
立即学习“Java免费学习笔记（深入）”；
-
thenCombine：同步执行，用“先完成者”的线程 -
thenCombineAsync：异步执行，用 ForkJoinPool.commonPool() 或指定的 Executor
例如指定线程池：
Javascript Sdk
下载
用于 inference.sh 的 JavaScript/TypeScript SDK，可运行 AI 应用、构建代理、集成 150+ 模型。包名：@inferencesh/sdk（npm install），完整 TypeScript 支持。
ExecutorService executor = Executors.newFixedThreadPool(4);
CompletableFuture<String> result = future1.thenCombineAsync(future2,
(a, b) -> a + "-" + b, executor);
异常处理不能靠 thenCombine 自动传递
thenCombine 本身不会捕获或处理前置任务的异常。如果任一前置 CompletableFuture 以异常结束，整个链会失败，后续的 thenCombine 不会执行，而是直接进入异常状态。
正确做法是提前对每个 Future 做容错处理：
CompletableFuture<String> safeFuture1 = future1.exceptionally(t -> "defaultA"); CompletableFuture<String> safeFuture2 = future2.exceptionally(t -> "defaultB"); safeFuture1.thenCombine(safeFuture2, (a, b) -> a + b);
或者统一用 handle 或 whenComplete 在最后兜底。
和 thenCompose 的区别要分清
别混淆 thenCombine 和 thenCompose：
-
thenCombine：两个独立 Future → 同时等待 → 用 BiFunction 合并结果 → 返回新 Future -
thenCompose：一个 Future → 它完成后返回另一个 Future → 扁平化链式依赖（类似 flatMap）
简单记：combine 是“并行+聚合”，compose 是“串行+接力”。
