怎么利用 CompletableFuture 的 exceptionally 与 handle 构建健壮的异步任务容错链路-java教程-PHP中文网

exceptionally仅捕获底层异常，不处理null或业务错误；handle统一处理结果与异常，需判空；容错链应分层拦截，exceptionally内勿抛异常。

怎么利用 completablefuture 的 exceptionally 与 handle 构建健壮的异步任务容错链路

exceptionally 只捕获上游异常，别指望它处理 null 或业务错误

它只在 completeExceptionally 被调用、或上游 lambda 抛出未捕获异常时触发。如果上游返回 null、false、-1 这类“逻辑失败”，exceptionally 完全不执行。

常见误用场景：

HTTP 接口返回 404，却在解析响应时抛 RuntimeException 再进 exceptionally——这混淆了网络层异常和业务语义
数据库查不到记录，本该返回 Optional.empty()，却 throw NoResultException 强行塞进异常流

真正该走 exceptionally 的，只有：ConnectException、JsonParseException、线程池拒绝、NullPointerException 在 IO 回调中意外发生等不可控底层问题。

handle 是唯一能同时看到 result 和 throwable 的统一入口

handle 无论成功失败都会执行，参数是 (T result, Throwable throwable)，但必须手动判空——漏掉 throwable == null 判断，直接对 result 调用方法，立刻 NPE。

典型写法：

future.handle((result, throwable) -> {
    if (throwable != null) {
        return fallbackByError(throwable);
    }
    return validateAndWrap(result); // result 此时才可信
});

注意点：

即使上游成功，handle 也必然执行，比 thenApply 多一次函数调用，在高并发下可感知
它内部若抛异常，会继续向后传播，不会被吞掉（这点和 exceptionally 不同）
适合做统一日志、结果校验、空值兜底、缓存回源等需上下文联动的操作

容错链不是堆方法，而是分层拦截 + 明确职责

一个健壮的链路，往往需要多个异常处理节点协同，而不是靠单个 exceptionally 一劳永逸。

MiroThinker

一款AI图像与设计工具，主要用于MiroMind团队推出的研究型开源智能体，专为深度研究与复杂工具使用场景设计，适合需要提升相关任务效率的用户。

下载

推荐组合模式：

在 IO 调用后立即接 exceptionally：处理连接超时、解析失败等底层异常，返回安全默认值（如空集合）
在数据转换阶段（如 thenApply）后加 handle：校验非空、字段合法性，对业务失败值做降级或包装
整个链末尾再补一层 exceptionally：兜底捕获前面所有漏掉的异常（比如 handle 里自己抛的新异常）

示例：

CompletableFuture.supplyAsync(() -> apiClient.getUser(uid))
    .orTimeout(800, TimeUnit.MILLISECONDS)
    .exceptionally(ex -> {
        log.warn("API timeout or network error", ex);
        return User.DEFAULT;
    })
    .thenApply(user -> enrichWithProfile(user)) // 可能 NPE 或校验失败
    .handle((enriched, ex) -> {
        if (ex != null) {
            log.warn("enrich failed", ex);
            return User.withFallbackProfile(enriched);
        }
        return enriched;
    })
    .exceptionally(ex -> {
        log.error("final fallback triggered", ex);
        return User.EMPTY;
    });