thenCombine 的触发条件是两个 CompletableFuture 都正常完成，任一未完成或异常完成则返回的 Future 保持未完成；合并函数按（本体结果、other 结果）顺序执行，且默认同步运行。
thenCombine 的触发条件必须是两个 CompletableFuture 都完成
它不会等一个、再启动另一个，也不会因为某个先失败就跳过另一个。只要任一参数 Future 处于未完成或异常完成状态，thenCombine 返回的 Future 就保持未完成；只有当两者都正常完成（即 result != null 且非 AltResult 封装异常），合并函数才会被调用。
常见错误现象包括：
- 误以为
thenCombine会“拉起”第二个任务 —— 实际上两个参数必须是**已启动且独立运行中**的CompletableFuture实例 - 在第一个 Future 还没提交时就调用
thenCombine，导致返回的 Future 永远卡在未完成状态 - 忽略线程池隔离：若两个任务共用
ForkJoinPool.commonPool()，而其中一个是 CPU 密集型，可能拖慢另一个 IO 型任务的完成时间
合并函数的参数顺序和类型必须严格匹配两个 CompletableFuture 的泛型
thenCombine 方法签名是 <U,V,W> CompletableFuture<W> thenCombine(CompletableFuture<U> other, BiFunction<U,V,W> fn)，注意：第一个参数是调用方的 result 类型（V），第二个参数 other 是传入的 Future 的 result 类型（U），但 BiFunction 的形参顺序是 (V, U) —— 即「本体结果在前，other 结果在后」。
容易踩的坑：
- 把
BiFunction<User, Order, UserOrder>写成BiFunction<Order, User, UserOrder>，编译报错但提示模糊（常表现为类型推导失败） - 合并函数内部抛出未捕获异常：这会导致整个
thenCombine返回的 Future 进入异常完成状态，且异常不会自动传播到后续thenApply等阶段，除非显式用exceptionally或handle - 合并函数执行耗时过长：它默认在「任意一个前置 Future 完成的线程」中同步执行（无
Async后缀），可能阻塞该线程 —— 若需解耦，应改用thenCombineAsync
thenCombine 不改变原有任务的生命周期，但影响下游依赖的触发时机
调用 thenCombine 不会重新提交或重启任一参数 Future，只是注册一个「双完成监听器」。它的返回值是一个新的 CompletableFuture<W>，其完成状态完全由两个输入 Future 和合并函数共同决定。
关键影响点：
- 若你对同一个
CompletableFuture多次调用thenCombine（比如分别和 A、B、C 合并），每个调用都会生成独立的新 Future，彼此不干扰 - 如果其中一个输入 Future 已经异常完成，
thenCombine返回的 Future 会立即进入异常完成状态，且携带的是那个异常 —— 此时合并函数根本不会执行 - 性能上：
thenCombine注册的BiRelay节点会被压入两个 Future 各自的stack，任一完成都会尝试触发；但只有当两者都完成时，才真正执行合并逻辑 —— 所以它本身几乎没有额外开销，瓶颈始终在两个上游任务和合并函数
别混淆 thenCombine 和 thenCompose，它们解决的问题完全不同
thenCombine 是「等两个都做完，再合起来」；thenCompose 是「做完第一个，拿它的结果去启动第二个」。前者要求两个 Future **启动时间无关、结果类型无关、执行路径完全独立**。
典型误用场景：
- 想先查用户，再用用户 ID 查订单，却写了
userFuture.thenCombine(orderFuture, (u, o) -> ...)—— 错！orderFuture必须提前构造好，不能依赖u - 把
thenCombine当作「兜底 fallback」：比如希望 A 失败时用 B 的结果顶替 —— 这不是thenCombine的职责，得用orTimeout+exceptionally或applyToEither - 在合并函数里又发起新异步调用（如远程写日志），却不包装成
CompletableFuture—— 这会让整个链变成同步阻塞，破坏非阻塞契约
最常被忽略的一点：thenCombine 的原子性只体现在「触发时机」上，不保证合并函数执行过程的线程安全。如果你在合并函数里修改了共享对象（比如往一个 ConcurrentHashMap 里 put），仍需自行加锁或使用线程安全结构。
