Java 中怎么用 exceptionally 捕获 CompletableFuture 异常-java教程-PHP中文网

exceptionally是completablefuture的异常处理方法，用于在上游异常时返回同类型兜底值而非中断链式调用；它不捕获异常而是将其转为正常结果，仅响应直接上游异常，不可用于重抛异常。

java 中怎么用 exceptionally 捕获 completablefuture 异常

exceptionally 是 CompletableFuture 提供的异常处理方法，用于在前序异步计算抛出异常时**提供一个备选结果（fallback）**，而不是中断整个链式调用。它不会“捕获并吞掉”异常，而是**把异常转化为一个正常返回值**，适合做兜底逻辑。

exceptionally 的基本用法

它接收一个 Function<throwable t></throwable>，参数是上游抛出的异常，返回值将成为整个 future 的完成结果（类型需与原始 future 一致）：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

如果上游成功完成，exceptionally 不执行，下游拿到原结果；
如果上游因异常完成（如 supplyAsync 中抛出 RuntimeException），则触发 exceptionally，返回其指定的默认值。

示例：

CompletableFuture<string> future = CompletableFuture
    .supplyAsync(() -> {
        if (Math.random() > 0.5) throw new RuntimeException("模拟失败");
        return "success";
    })
    .exceptionally(throwable -> {
        System.err.println("发生异常：" + throwable.getMessage());
        return "default_value"; // 返回兜底字符串，类型必须是 String
    });

System.out.println(future.join()); // 输出 "success" 或 "default_value"
</string>

和 handle、whenComplete 的区别

别混淆这三个方法：

exceptionally：只在异常时执行，**必须返回同类型结果**，用于“异常 → 默认值”转换；
handle(BiFunction)：无论成功或失败都执行，接收 (result, throwable) 两个参数，可统一处理并返回新结果；
whenComplete(BiConsumer)：只做副作用（如打日志、清理资源），不改变结果，返回仍是原 future。

常见误区提醒

不能用 exceptionally 来“记录日志后重新抛异常”——它设计目标是返回值，不是异常传播；真要重抛，改用 handle 并手动 throw；
它只响应**上游直接抛出的异常**，对下游（如 thenApply）中抛的异常无效——异常发生在哪个 stage，就由该 stage 后紧跟的 exceptionally（或 handle）捕获；
如果想“捕获异常 + 继续异步流程”，可链式调用：exceptionally(...).thenApply(...)，后续操作基于 fallback 值继续。