thenCompose用于串行组合两个异步任务，当前一个任务结果作为后一个异步任务的输入，自动展平嵌套CompletableFuture；区别于thenApply，后者返回普通值，而thenCompose接收并返回CompletableFuture。
thenCompose 是 Java CompletableFuture 中用于**串行组合两个异步任务**的关键方法，特别适合后一个任务**依赖前一个任务的返回结果**（即“结果驱动下一个异步操作”）的场景。它和 thenApply 的核心区别在于：
thenCompose 接收一个函数，该函数返回一个新的 CompletableFuture；而 thenApply 返回的是普通值（会自动包装成 CompletableFuture）。因此，thenCompose 能避免“嵌套的 CompletableFuture”（即 CompletableFuture<completablefuture>></completablefuture>），实现扁平化链式调用。
为什么不用 thenApply？
假设你有：
- 任务 A：查询用户 ID → 返回
CompletableFuture<long></long> - 任务 B：根据用户 ID 查询订单列表 → 返回
CompletableFuture<list>></list>
如果错误地用 thenApply：
CompletableFuture<Long> userIdFuture = getUserById("alice");
CompletableFuture<CompletableFuture<List<Order>>> nested = userIdFuture.thenApply(id -> getOrdersByUserId(id)); // 返回的是 CompletableFuture<CompletableFuture<...>>
这会导致类型混乱、难以后续处理。而 thenCompose 正是为此设计：
CompletableFuture<Long> userIdFuture = getUserById("alice");
CompletableFuture<List<Order>> ordersFuture = userIdFuture.thenCompose(id -> getOrdersByUserId(id));
// 类型是 CompletableFuture<List<Order>>，可直接 .join() 或继续链式调用
典型使用模式：结果驱动下一步异步调用
常见于数据库查询、HTTP 调用、缓存穿透防护等需要“先查 ID 再查详情”的流程：
立即学习“Java免费学习笔记（深入）”；
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
- 用户登录 → 获取 token → 用 token 调用用户中心接口获取完整信息
- 读取配置 key → 根据 value 中的 service name → 异步调用对应微服务
- 校验验证码 → 成功后 → 异步生成并发送 JWT
关键点：第二个操作本身是异步的（返回 CompletableFuture），且必须用前一个任务的**解包后的结果**作为输入参数。
与 thenCompose 相关的常用变体
注意区分语义，避免误用：
-
thenComposeAsync：在指定线程池（或默认 ForkJoinPool）中执行函数，适用于耗时计算或 I/O 操作 -
thenAcceptBoth/runAfterBoth：两个独立任务都完成后才执行，不依赖彼此结果（并行非依赖） -
handle或whenComplete：用于统一处理成功/异常，不改变返回类型
例如，想在 IO 线程池中执行后续查询，可写：
ExecutorService ioPool = Executors.newCachedThreadPool(); userIdFuture.thenComposeAsync(id -> getOrdersByUserId(id), ioPool);
异常传播与错误处理
thenCompose 会自然传递上游异常：如果第一个 future 失败，函数不会执行，整个链直接失败；如果函数内部抛出异常或返回的 future 自身 failed，下游也会失败。
推荐搭配 exceptionally 或 handle 做兜底：
userIdFuture
.thenCompose(id -> getOrdersByUserId(id))
.exceptionally(ex -> {
log.error("获取订单失败", ex);
return Collections.emptyList();
});
