Java 中怎么使用 exceptionally 处理异步任务中的异常信息-java教程-PHP中文网

exceptionally专门捕获前序阶段的未检查异常，接收function并返回同类型completablefuture，仅异常时执行并提供兜底值，确保链式调用不中断；对受检异常无效，需主动包装为runtimeexception或completionexception。

java 中怎么使用 exceptionally 处理异步任务中的异常信息

在 Java 的 CompletableFuture 中，exceptionally 是专门用于捕获并处理异步任务中抛出的异常的方法。它只在前序阶段（如 supplyAsync、thenApply 等）发生未检查异常（即 RuntimeException 或其子类）时被调用，不会响应 checked exception（除非它们被包装进运行时异常）。

exceptionally 的基本用法

exceptionally 接收一个 Function<throwable t></throwable> 类型的函数，参数是异常对象，返回值类型需与前序阶段的完成结果类型一致（即“兜底值”）。它返回一个新的 CompletableFuture，原任务链不会中断，后续的 thenApply、thenAccept 等仍可正常执行。

示例：

CompletableFuture<string> future = CompletableFuture.supplyAsync(() -> {
    if (Math.random() > 0.5) throw new RuntimeException("模拟失败");
    return "success";
}).exceptionally(throwable -> {
    System.err.println("捕获异常: " + throwable.getMessage());
    return "fallback result"; // 返回默认值，类型必须是 String
}).thenApply(result -> result.toUpperCase());

System.out.println(future.join()); // 输出可能是 "SUCCESS" 或 "FALLBACK RESULT"
</string>

exceptionally 只捕获运行时异常

它对受检异常（Exception 及其非 RuntimeException 子类）无效——因为 CompletableFuture 的计算函数（如 Supplier、Function）声明不抛出受检异常，编译器不允许直接 throw。若业务逻辑中可能抛出受检异常，需主动包装：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

用 try-catch 捕获后转为 RuntimeException（如 new RuntimeException(e)）再抛出
或使用 CompletionException 包装（这是 CompletableFuture 内部推荐方式）

与 handle 和 whenComplete 的区别

exceptionally 专注异常路径，不感知正常结果；而：

handle(BiFunction<t throwable r>)</t>：无论成功或失败都执行，两个参数分别接收结果和异常（异常为 null 表示成功）
whenComplete(BiConsumer<t throwable>)</t>：类似 handle，但不改变结果值，仅做副作用（如日志、清理），返回原 CompletableFuture

如果既要统一处理结果/异常，又需要转换值，优先选 handle；如果只想提供降级值，exceptionally 更语义清晰、不易出错。