exceptionallyCompose 是 CompletableFuture 的异步降级方法，仅在上游异常完成时触发，接收 Function 并返回新 CompletableFuture，支持嵌套异步降级与多步联动。
exceptionallyCompose 是 CompletableFuture 提供的异常处理方法，用于在前序异步任务抛出异常时，**以新的异步任务替代原链路**，实现真正的“异步降级”——即降级逻辑本身也是非阻塞、可组合的。
理解 exceptionallyCompose 的作用时机和签名
它只在上游 CompletableFuture 以 Throwable 完成（即 completeExceptionally 或执行中抛出未捕获异常）时触发；与 exceptionally（返回普通值）不同，exceptionallyCompose 接收一个 Function<throwable completablefuture>></throwable>，返回一个新的 CompletableFuture，从而延续异步链路。
关键签名：
publicFunction
典型异步降级场景：远程调用失败后查本地缓存
比如主流程是调用 HTTP 接口获取用户信息，失败后不直接返回空或默认值，而是异步查询 Redis 缓存（同样可能失败，需继续兜底）：
立即学习“Java免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 主任务：
fetchUserFromRemote()→ 返回CompletableFuture<user></user> - 降级任务：
fetchUserFromCache(userId)→ 也返回CompletableFuture<user></user>，内部用 Lettuce 异步 API - 二次降级：
provideDefaultUser()→ 返回已知的CompletableFuture.completedFuture(new User("guest"))
组合写法：
fetchUserFromRemote(userId).exceptionallyCompose(ex -> {
if (ex instanceof TimeoutException) {
return fetchUserFromCache(userId)
.exceptionallyCompose(ex2 -> provideDefaultUser()); // 可继续 compose
} else {
return provideDefaultUser();
}
});
注意事项：避免在 lambda 中阻塞或抛异常
exceptionallyCompose 的函数体必须返回一个 CompletionStage。常见错误包括：
- 直接 return 一个普通对象（如
new User("fallback")）→ 编译不通过 - 在 lambda 内部调用
get()等阻塞方法 → 破坏异步性，可能死锁 - lambda 里再抛出未捕获异常 → 该异常会成为新 future 的异常结果，不会触发下一级
exceptionallyCompose（除非显式再套一层） - 忽略异常类型区分 → 建议按异常分类选择不同降级策略（如网络超时走缓存，404 走默认值，500 记录告警后重试）
与 exceptionally / handle 的关键区别
对比更常用的异常处理方式：
-
exceptionally(Function<throwable t>)</throwable>：只能返回同步值，降级逻辑无法异步展开，适合简单兜底（如返回 null、空集合） -
handle(BiFunction<t throwable r>)</t>：无论成功失败都执行，但仍是同步回调，且需手动判空/判异常 -
exceptionallyCompose：真正支持“异常路径上的异步流水线”，可嵌套、可重试、可日志+通知+降级多步联动
例如：记录异常日志 + 发送告警消息（异步）+ 查询备用服务，三者可串成一个 thenCompose 链，整体作为 exceptionallyCompose 的返回值。
