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 为什么拿不到各个任务的结果?
因为 allOf 只表示「一组阶段全部完成」,返回类型是 CompletableFuture<Void>,不收集各个计算结果。调用方要自己保留原来的 Future 列表,聚合正常完成后逐个读取结果;有失败时,再按业务规则决定整体报错,还是保留部分结果。
9. 面试题卡片
10. 参考资料
来源:Coding 101 原文 · 免费阅读,引用请保留出处。内容使用说明