跳到主要内容
约 9 分钟3 张卡

CompletableFuture

CompletableFuture 是 Java 里组织异步结果的工具:你可以先拿到一个代表「将来的结果」的对象,再声明结果出来以后要做什么。每一步计算及其结果称为一个完成阶段,前一个阶段完成,会触发依赖它的后续阶段。

用 CompletableFuture 写出能跑的代码不难,难的是出问题时的行为:回调在哪个线程上执行,异常怎样一层层传下去,超时和取消到底停掉了什么,多个任务一起等时谁失败算失败。这几点决定了异步代码在线上会不会拖垮线程池、吞掉错误。下文以 Java 17 和 21 为准。

1. 面试核心​

先记住这几条,再读正文
  • thenCompose 把回调返回的异步阶段展平为一层结果,thenCombine 等两个阶段都正常完成后合并结果。
  • 不指定执行器的 Async 方法默认使用 ForkJoinPool.commonPool();公共池并行度小于 2 时,改为每个任务新建一个线程。卡 · 回调的执行线程
  • exceptionally 和 handle 返回替代值,会把失败恢复为成功;只在业务允许降级时这样做。
  • 原阶段成功时,whenComplete 的回调抛错会让它返回的新阶段异常完成。卡 · 观察回调的异常
  • allOf 等全部输入都完成后才报告结果,任一输入失败,聚合结果就失败;anyOf 随任一输入完成而完成,包括失败。卡 · allOf 与 anyOf 的完成条件
  • CompletableFuture.cancel(true) 只是以取消异常完成这个 Future,底层任务要靠自己的机制退出。

2. Future 的结果与异常​

Future 代表一个异步计算的结果:任务提交后马上就能拿到它,计算完成之前也能拿。它提供读取结果、限时等待和取消。调用 get 时,当前线程会一直等到计算完成:

Future<Profile> future = executor.submit(() -> loadProfile(id));

try {
Profile profile = future.get(300, TimeUnit.MILLISECONDS);
} catch (ExecutionException exception) {
Throwable cause = exception.getCause();
handleFailure(cause);
}

这段代码最多等 300 毫秒,成功时拿到 Profile。任务自己抛了异常,get 会把它包装成 ExecutionException 抛出,代码用 getCause() 取出原始原因。等待期间被中断或超时,则分别抛出 InterruptedException 和 TimeoutException,示例省略了这两个分支,外围方法还要处理或声明它们。

submit 不会把任务的异常直接打印出来,而是记录在返回的 Future 里。如果提交方把 Future 丢掉了,又没有别的地方记录失败,这个异常就再也没人读到,任务等于悄悄失败了。

FutureTask 的 cancel(true) 会尝试中断正在执行任务的线程,任务能不能退出,取决于它是否响应中断,具体见 任务取消。

3. CompletionStage 的依赖组合​

Future 只能等结果,CompletionStage 则描述结果出来以后接着做什么。CompletableFuture 实现了这个接口,所以不用让调用线程一步步阻塞等待,可以直接把计算之间的依赖连起来。

比如订单和客户数据互不依赖,可以并行加载,再合并成订单视图:

CompletableFuture<OrderView> view =
CompletableFuture.supplyAsync(() -> loadOrder(id), ioExecutor)
.thenCombine(
CompletableFuture.supplyAsync(
() -> loadCustomer(id), ioExecutor),
OrderView::new
);

两个加载任务都提交给了 ioExecutor,同时进行。只有两者都正常完成,才会调用 OrderView::new 生成最终视图;任意一个失败,view 就以那个异常完成。

组织依赖时最常用三种组合方式:

  • thenApply 把一个结果值转换成另一个值,适合普通的结果映射。
  • thenCompose 的回调返回另一个异步阶段,它会把嵌套的结果展平,适合「下一步异步调用依赖上一步结果」的场景。
  • thenCombine 等两个阶段都正常完成后合并结果,适合汇合互相独立的任务。

区分并行和串行的依据是数据依赖:需要前一步输出的任务,应在前一步成功后通过 thenCompose 启动;只有互相独立的任务,才适合像示例这样直接并行提交。

4. 回调的执行线程​

阶段之间的顺序定好了,还要弄清每个回调由哪个线程执行。不注意这一点,一段慢回调就可能占住完成上一步的网络线程或者调用方线程。

不带 Async 后缀的回调,比如 thenApply,由完成当前阶段的线程执行,也可能由其他调用完成方法的线程执行。如果注册回调时阶段已经完成了,注册回调的线程会直接执行它。所以你没法确定它在哪个线程上跑,只能保证它跑得快。

带 Async 后缀又没有显式传入 Executor 时,Java 17 和 21 默认使用 ForkJoinPool.commonPool()。这是整个 JVM 里不同业务共享的公共线程池;它的并行度小于 2 时(比如只有一两个 CPU 核心),每个异步任务会新建一个线程。子类还可以重写 defaultExecutor() 改变实例方法的默认执行器。显式传入 Executor 时,任务交给指定的执行器。

问题在于慢 I/O 会长时间占住线程。几个业务共用公共池,其中一个的下游变慢,其他业务的任务也会排队。需要隔离的依赖应使用专用执行器,并设置容量上限、监控排队和拒绝情况。执行器的容量与拒绝规则见 Java 线程池。

5. 异常恢复与观察​

一个阶段失败后,异常会沿着依赖链往下传,后续依赖它的阶段也会异常完成,直到遇到处理异常的回调。业务要决定的是:把失败恢复成一个可用的结果,还是让异常继续传播。三种回调各管一件事:

  • exceptionally 只在失败时执行,计算一个替代结果,适合业务允许的降级。
  • handle 在成功或失败时都执行,把两种完成状态统一转换成新结果。
  • whenComplete 拿到结果和异常,但不改变结果,用来记录日志或指标;回调正常返回时,新阶段保留原来的结果。
future.whenComplete((value, error) -> metrics.record(error));

这行代码用 whenComplete 记录失败指标。它返回的是一个新阶段,如果 metrics.record 自己抛了异常,也会影响这个新阶段,见下一小节。

exceptionally 和 handle 的回调正常返回时,后续阶段得到的是成功结果。也就是说,返回一个默认值就把原来的失败变成了成功,下游再也看不出曾经失败过。只有业务允许降级时才这样做,并且要记下错误指标;否则就让异常继续传播,到业务边界再统一处理。回调自己抛错时,后续阶段仍会失败。

最后读取结果时,异常的类型取决于读取方法:

  • get() 把计算异常包装成受检的 ExecutionException,调用方需要捕获或声明。
  • join() 把它包装成非受检的 CompletionException。
  • 被直接取消的 Future,调用 get() 或 join() 都会抛出 CancellationException。

记录日志或按异常去重时,要先解开这层包装,保留原始的 cause,才能看出真正失败的是哪个调用。

5.1 观察回调的异常​

观察结果的代码自己也可能失败,这时要分清是原阶段失败了,还是回调失败了。规则是:

  • 回调正常返回,新阶段保留原结果。
  • 原阶段成功、回调抛错,新阶段以回调的异常完成。
  • 原阶段失败、回调也抛错,新阶段保留原阶段的异常。

下面让一个成功结果的观察回调主动抛错:

CompletableFuture<Integer> next =
CompletableFuture.completedFuture(1)
.whenComplete((value, error) -> {
throw new IllegalStateException("metrics failed");
});

调用 next.join() 会抛出 CompletionException,它的 cause 是回调抛出的 IllegalStateException。completedFuture(1) 创建的原 Future 仍然是成功的,失败的是 whenComplete 返回的新阶段 next。所以日志、指标这类观察回调要自己处理失败,否则一次指标上报出错,就会让依赖 next 的业务逻辑跟着失败。

6. 超时与取消的作用范围​

超时和取消改变的是 Future 的状态,不会自动停掉产生结果的网络或数据库调用,这些调用有自己的生命周期。所以设置超时和取消时,要把 Future 状态和底层任务分开处理。

Java 17 和 21 中,orTimeout 在期限到达、结果还没完成时,让它以 TimeoutException 异常完成;completeOnTimeout 则在同样的情况下用一个默认值正常完成。两者都修改并返回当前这个 CompletableFuture,底层的外部调用仍然在跑,要单独给它设置超时。

cancel 把当前结果标记为取消,但 mayInterruptIfRunning 参数在 CompletableFuture 里不起作用,它不会去中断执行任务的线程。取消只是以 CancellationException 完成这个 Future,任务是否退出,取决于外部调用自己的取消机制。

组合多个调用时,需要把超时与取消的策略定清楚:

  • 从请求入口传递截止时间,让后续阶段知道还剩多少时间可用。
  • 给每个外部调用设置超时,并安排好底层任务怎样退出。
  • 一个阶段失败后,决定其他并行的任务是取消、继续等待,还是保留已经拿到的结果。

7. allOf 与 anyOf 的完成条件​

同时启动多个任务后,聚合阶段什么时候结束,取决于用的是哪个方法。allOf 要等所有输入阶段都完成,只要其中有一个异常,聚合结果就异常完成。注意它不会快速失败:一个任务很早就失败了,它仍然会等其他任务结束。

anyOf 在任意一个输入完成时就完成。最先完成的输入即使是失败,聚合结果也跟着失败,所以它不是「等第一个成功的」。需要「首个成功」的策略,要自己记录成功结果和失败数量,全部失败了再报告失败。

两个方法都不会停止其他任务,需要停掉剩下的任务时,由调用方自己安排取消。还有一个边界:输入为空时,allOf 立即正常完成,anyOf 则一直保持未完成。

8. 常见问题​

8.1 thenApply 与 thenCompose 有什么区别?​

看回调返回什么:返回普通值用 thenApply,返回另一个 CompletionStage 用 thenCompose。如果把一个返回异步阶段的回调交给 thenApply,结果类型会嵌套成 CompletableFuture<CompletableFuture<T>>。thenCompose 会把它展平,调用方直接等最终的 T。

8.2 allOf 为什么拿不到各个任务的结果?​

9. 面试题卡片​

10. 参考资料​

来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明