CompletableFuture默认将非受检异常包装为CompletionException并中断链式调用，需在链内用exceptionally()或handle()显式处理，避免异常静默丢失。
CompletableFuture 默认会把非受检异常（如 RuntimeException、NullPointerException）包装成 CompletionException，并终止后续链式调用。要可靠捕获和处理这类异常，不能只依赖 try-catch 外层代码，而需在异步链内部显式介入。
用 exceptionally() 捕获链中任意阶段的非受检异常
这是最常用、最直接的方式。它会在当前 CompletableFuture 完成时抛出异常（包括被包装的非受检异常）时触发，返回一个默认值或替代结果。
示例：
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
if (Math.random() > 0.5) throw new IllegalArgumentException("模拟业务异常");
return "success";
}).exceptionally(throwable -> {
// throwable 是 CompletionException，其 cause 才是原始异常
Throwable cause = throwable.getCause();
System.err.println("捕获到异常: " + cause);
return "fallback result";
});
- 注意：传入
exceptionally的参数是CompletionException或ExecutionException，需调用getCause()获取原始非受检异常 - 该方法只影响当前 stage，后续
thenApply等仍可正常执行 - 若想继续传播异常（比如转为自定义错误），可在
exceptionally中重新 throw
用 handle() 统一处理成功与失败场景
当需要对结果和异常做统一判断（比如记录日志、转换状态、返回封装对象），handle 更灵活——它无论成功或失败都会执行，且能同时拿到结果和异常。
立即学习“Java免费学习笔记（深入）”；
示例：
CompletableFuture<Result<String>> resultFuture = CompletableFuture.supplyAsync(() -> {
throw new NullPointerException("空指针");
}).handle((result, ex) -> {
if (ex != null) {
// ex 就是 CompletionException，getCause() 得到原始异常
return Result.error(ex.getCause());
}
return Result.success(result);
});
-
handle的第二个参数ex在成功时为null，失败时为包装异常 - 适合构建统一响应体（如
Result<T>）、埋点统计、兜底降级等场景 - 返回值会成为新 CompletableFuture 的结果，类型可变
避免异常“静默丢失”：慎用 thenAccept / thenApply 的无异常重载
像 thenAccept、thenApply 这类不带异常处理能力的方法，一旦上游抛出非受检异常，整个链会中断，且异常可能被吞掉（尤其在线程池未配置未捕获异常处理器时）。
- 错误写法：
future.thenApply(this::process).thenAccept(System.out::println)—— 若process抛异常，下游不会执行，异常也难追踪 - 推荐做法：所有关键链路末尾加
whenComplete或exceptionally做兜底 - 开发期可在 ForkJoinPool.commonPool() 或自定义线程池中设置
UncaughtExceptionHandler，辅助定位漏处理的异常
自定义异步执行器 + 异常透传增强
如果项目中大量使用 CompletableFuture，可封装一个工具方法，自动解包并透传原始异常，减少重复判空和 getCause()：
public static <T> CompletableFuture<T> safeSupplyAsync(Supplier<T> supplier) {
return CompletableFuture.supplyAsync(() -> {
try {
return supplier.get();
} catch (RuntimeException e) {
throw e; // 非受检异常直接抛，不包装
} catch (Exception e) {
throw new CompletionException(e); // 受检异常转为 CompletionException
}
});
}
配合自定义线程池（如 new ThreadPoolExecutor(...) 并设置 setUncaughtExceptionHandler），能更早暴露问题。
不复杂但容易忽略。关键是把异常处理“下沉”到异步链内部，而不是寄希望于外层 try-catch。
