正确处理CompletableFuture异常需显式捕获，因异常被封装而不自动抛出；应使用handle、whenComplete或exceptionally方法统一处理，区分受检与非受检异常，组合时监控各阶段失败，并在关键节点添加日志以增强可观测性。
在Java中使用CompletableFuture进行异步编程时，异常处理是不可忽视的关键环节。如果处理不当，异常可能被静默吞掉，导致程序行为难以调试。掌握正确的异常处理方式，能显著提升代码的健壮性和可维护性。
异常不会自动抛出，需显式捕获
CompletableFuture中的异常不会像同步代码那样直接中断流程，而是封装在Future内部。如果不调用get()或未设置异常回调，异常将被忽略。
正确做法是在链式操作中使用以下方法之一：
-
handle(BiFunction
) ：无论是否发生异常都会执行，可用于统一处理结果和异常 -
whenComplete(BiConsumer
) ：类似handle，但不改变返回值，适合日志记录或资源清理 -
exceptionally(Function
) ：仅在发生异常时触发，用于降级或默认值返回
CompletableFuture.supplyAsync(() -> {
if (Math.random() < 0.5) throw new RuntimeException("失败");
return "成功";
}).exceptionally(ex -> {
System.out.println("捕获异常: " + ex.getMessage());
return "默认值";
});
区分受检与非受检异常
CompletableFuture只能传播RuntimeException。若任务中抛出受检异常（如IOException），必须在lambda内部处理或包装为运行时异常。
立即学习“Java免费学习笔记（深入）”；
建议做法：
- 在
supplyAsync或runAsync中使用try-catch包裹外部API调用 - 将受检异常转换为自定义运行时异常，便于上层识别
CompletableFuture.supplyAsync(() -> {
try {
return riskyOperation(); // 可能抛出IOException
} catch (IOException e) {
throw new CompletionException(e);
}
});
组合多个Future时的异常传递
当使用thenCompose、thenCombine或allOf等组合方法时，任何一个前置任务失败都会导致整个链失败。
关键点：
-
CompletableFuture.allOf()不会自动聚合异常，需手动检查每个future的isCompletedExceptionally() - 使用
join()代替get()避免抛出InterruptedException或ExecutionException - 在
handle中判断哪个阶段出错，便于定位问题源头
CompletableFuture.allOf(f1, f2).handle((__, ex) -> {
if (ex != null) {
System.out.println("组合任务失败: " + ex);
}
return null;
});
全局异常监控与日志记录
对于关键业务逻辑，可在whenComplete中添加统一的日志输出，确保所有异常都被记录。
推荐模式：
- 每个重要链的末尾添加
whenComplete用于监控 - 结合MDC写入追踪ID，方便排查分布式上下文中的错误
- 避免在
exceptionally中吞掉异常而不记录
future.whenComplete((result, ex) -> {
if (ex != null) {
log.error("异步任务执行失败", ex);
} else {
log.info("任务完成，结果: {}", result);
}
});
基本上就这些。关键是意识到异步异常的隐蔽性，主动设计恢复策略和可观测性。合理使用handle和exceptionally，配合日志，就能写出既高效又稳定的异步代码。
