exceptionally仅在异常时执行且返回同类型值，handle则无论成功或失败均执行并支持类型转换；二者常组合使用，handle做可观测性处理，exceptionally作最终兜底。
在 CompletableFuture 中，exceptionally 和 handle 是两种常用且互补的异常处理方式。它们的区别在于：前者只在发生异常时执行，且必须返回与原始结果同类型的值；后者无论成功或失败都会执行，可统一处理结果和异常，更灵活。
exceptionally：专用于兜底异常恢复
当你只想在异步任务抛出异常时提供一个默认值或降级逻辑，用 exceptionally 最直接。它接收一个 Throwable 参数，返回与原始 CompletableFuture 泛型类型一致的结果。
- 只在链中上游出现未捕获异常时触发，正常完成则被跳过
- 适合返回默认值（如空列表、缓存数据、占位对象）
- 不能获取原始成功结果，也无法区分异常类型做分支处理（需配合
instanceof）
示例：
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {throw new RuntimeException("服务不可用");
}).exceptionally(ex -> "备用响应");
// future 结果为 "备用响应"
handle：统一收口，兼顾成功与异常
handle 是更通用的回调方法，接受两个参数：结果（可能为 null）和异常（可能为 null），二者必居其一。它不改变原始 CompletableFuture 的完成状态，适合做日志记录、指标上报、类型转换或条件化 fallback。
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 无论成功或失败都执行，天然支持“后置处理”语义
- 可通过判空分别处理 result 和 throwable，逻辑清晰
- 返回值类型可与原类型不同（支持泛型转换）
示例：
CompletableFuture<Integer> future = CompletableFuture.supplyAsync(() -> 42).handle((result, ex) -> {
if (ex != null) {
log.error("请求失败", ex);
return -1;
} else {
log.info("成功获取: {}", result);
return result * 2;
}
});
组合使用：先 handle 做可观测性，再 exceptionally 做强兜底
实际开发中常将两者串联：用 handle 记录日志或打点，再用 exceptionally 提供最终 fallback 值，兼顾可观测性和健壮性。
-
handle不中断链式调用，适合插入监控逻辑 -
exceptionally放在末尾，确保整个链总有可用结果 - 避免在
handle中吞掉异常却不处理——若需重抛，应显式 throw
示例：
CompletableFuture<User> userFuture = fetchUserAsync(userId).handle((user, ex) -> {
if (ex != null) {
metrics.counter("user.fetch.fail").increment();
} else {
metrics.counter("user.fetch.success").increment();
}
return user; // 原样透传，不改变结果
})
.exceptionally(ex -> new User("anonymous", "N/A"));
注意点：别混淆 thenApply/thenAccept 与 handle
thenApply 和 thenAccept 只在前序成功完成时执行，遇到异常会直接传播，**不会触发**。若在它们之后接 exceptionally，只能捕获它们内部抛出的新异常，而非上游异常。
- 想统一处理整个链的异常，
handle或最外层exceptionally更可靠 -
whenComplete类似handle，但不支持返回新结果（返回 void），适合纯副作用操作 - 不要在
exceptionally中抛出新异常——会导致后续exceptionally再次触发，容易引发意料外的链式失败
