exceptionally是CompletableFuture的异常兜底方法，仅在上游抛异常时触发，接收Throwable并返回同类型值以实现流程不中断；它不处理正常结果，不可用于日志钩子，需兼顾可观测性与类型兼容。
在 Java 异步编程中，exceptionally 是 CompletableFuture 提供的专用异常兜底方法，它不打断链式流程，而是当上游阶段抛出异常时，自动触发回调并返回一个替代结果，实现“失败可降级、流程不中断”的容错效果。
兜底的核心逻辑：只在异常时生效，且必须返回同类型值
exceptionally 接收一个 Function<Throwable, T>，参数是原始异常对象，返回值类型必须与 CompletableFuture 的泛型一致。它不会处理正常完成的结果，也不会改变成功路径的行为。
- 若上游无异常，exceptionally 回调完全不执行，后续 thenApply/thenAccept 等照常接收原始结果
- 若上游抛出 RuntimeException 或包装后的受检异常（如 new CompletionException(e)），exceptionally 会被触发
- 返回值会成为整个 CompletableFuture 的最终结果，下游操作看到的就是这个兜底值
典型兜底方式：日志 + 默认值 + 类型兼容
实际使用中，兜底不是简单吞掉异常，而是兼顾可观测性与业务连续性：
- 先记录异常关键信息（如 message、class、必要堆栈片段），避免静默失败
- 返回语义明确的默认值，比如空集合、0、"N/A"、缓存快照或本地模拟数据
- 确保返回值类型严格匹配，例如
CompletableFuture<String>的 exceptionally 必须返回 String，不能返回 null（除非业务允许）
CompletableFuture<Order> orderFuture = CompletableFuture.supplyAsync(() -> apiClient.getOrder(orderId))<br> .exceptionally(ex -> {<br> log.warn("订单查询失败，使用兜底数据", ex);<br> return Order.builder().id(orderId).status("UNKNOWN").build(); // 类型一致，结构完整<br> });
立即学习“Java免费学习笔记（深入）”；
和 handle / whenComplete 的关键区别
别把 exceptionally 当成万能日志钩子——它的设计目标很明确：仅用于异常恢复。
- exceptionally：只在异常时调用，可改结果，适合兜底值注入
- handle：无论成功失败都调用，参数含 result 和 exception，适合统一转换或兜底+成功双路径处理
- whenComplete：只做副作用（如关闭资源、发监控事件），不能修改结果，也不应抛出新异常
进阶兜底技巧：组合 fallback 与重试边界
真实场景中，单纯返回默认值可能不够。可结合其他机制增强鲁棒性：
- 在 exceptionally 内部调用轻量级本地服务或读取本地缓存，而非硬编码字符串
- 对特定异常类型（如 TimeoutException）走强兜底，对 IllegalArgumentException 等业务错误仍抛出，避免掩盖逻辑问题
- 配合超时控制：
orTimeout(3, TimeUnit.SECONDS).exceptionally(...)，防止无限等待 - 避免在 exceptionally 中执行耗时或可能再抛异常的操作（如远程调用），否则可能引发二次失败
