completablefuture 优雅降级需分层设计：上游获取类必须兜底，纯计算类应抛异常，下游写入类用 whencomplete 做副作用；善用 exceptionally、handle、whencomplete 各司其职；叠加超时熔断与多级 fallback；降级时须保留关键上下文日志。
CompletableFuture 的优雅降级，核心在于“异常不穿透、结果可预期、业务不中断”。它不是简单 catch 一下再 return 默认值，而是要结合异常传播特性、回调时机和业务语义，分层设计兜底路径。
明确降级边界：按阶段决定谁该兜底
链式调用中，并非所有环节都适合或需要降级。关键看该阶段失败是否影响后续逻辑的可行性：
- 上游数据获取类（如查库、调第三方）：必须兜底。比如用户信息查询失败，可用缓存、空对象或默认用户替代，避免整个流程中断。
- 纯计算类（如格式转换、字段拼接）：通常不应兜底，而应抛出明确异常让上层感知——这类错误多属程序缺陷，掩盖反而难排查。
-
下游写入类（如发消息、记日志）：建议用
whenComplete做副作用处理，失败可打告警但不阻断主链路。
选对 API：exceptionally、handle 与 whenComplete 各司其职
三者触发时机和用途差异明显，混用会导致逻辑混乱：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
exceptionally(Function<throwable t>)</throwable>：只在异常时执行，返回替代结果，用于真正“替换失败结果”的场景。例如：.exceptionally(e -> { log.warn("支付查询超时，走保底逻辑", e); return PayResult.builder().status("UNKNOWN").build(); }) -
handle(BiFunction<t throwable r>)</t>：无论成功失败都执行，适合统一收口、补充上下文或做结果归一化。例如：.handle((result, ex) -> ex != null ? wrapError(ex) : enrichResult(result)) -
whenComplete(BiConsumer<t throwable>)</t>：只做副作用（如打日志、关资源），不改变结果，也不影响异常流向。例如：.whenComplete((res, ex) -> Metrics.counter("order.create", "status", ex == null ? "success" : "fail").increment())
组合式兜底：多层级 fallback + 超时熔断
单一 exceptionally 不足以应对复杂依赖。真实场景常需叠加策略：
- 先加
orTimeout(3, SECONDS)主动中断慢请求，防止线程池雪崩； - 再用
exceptionally处理超时异常，返回缓存或静态兜底数据； - 若缓存也失效，可进一步调用轻量级备用服务（如本地规则引擎），用
thenCompose衔接：.exceptionally(e -> fallbackToCache())<br> .thenCompose(result -> result != null ? completedFuture(result) : callBackupService())
避免静默失败：异常信息不能丢
降级不等于吞异常。常见错误是 exceptionally 里只打印日志却不记录关键上下文，导致线上无法定位根因：
- 务必在日志中包含原始异常类型、消息、关键业务参数（如订单号、用户ID）；
- 不要用
e.printStackTrace()，改用结构化日志记录堆栈； - 对敏感异常（如
SQLException）做脱敏处理，但保留错误码和 SQL 状态码。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
