JavaCompletableFuture异常处理：exceptionally与handle详解

Java中CompletableFuture的exceptionally与handle虽都用于异常响应，但语义截然不同：exceptionally仅捕获真正中断执行流的底层异常（如超时、NPE、IO错误），对null、404响应、空查询等业务失败完全无感，且内部抛异常会被静默吞掉；而handle则统一处理成功与异常两种结果，需手动判空和分流，支持上下文感知的恢复逻辑（如“异常时查缓存”），且抛出的新异常会继续传播。选错方法不仅导致兜底失效、调试困难，更会混淆系统错误与业务语义——关键不在语法怎么写，而在清晰界定“什么是错、什么是空”。

exceptionally 只捕获上游异常，不能处理正常返回值

当你用 exceptionally 捕获异常时，它只在上游 CompletableFuture 以 completeExceptionally 结束（或抛出未捕获异常）时触发；如果上游成功完成，哪怕返回 null 或逻辑错误值，exceptionally 完全不执行。

• 典型误用：想用 exceptionally 把空结果转成默认值——这不行，它对 null、false、-1 这类“业务失败”无感
• 适合场景：网络超时、NPE、IO 异常等真正中断链路的错误，需要兜底返回一个安全对象（如空集合、默认配置）
• 参数只有一个：Throwable，无法访问原始计算结果，所以没法做“异常时查缓存”这类依赖上下文的恢复

future.exceptionally(t -> {
    log.error("call failed", t);
    return Collections.emptyList(); // 只能靠 Throwable 做判断
});

handle 能同时响应成功和异常，但必须自己区分路径

handle 是真正的二合一回调：无论上游是 complete 还是 completeExceptionally，它都会执行，且把结果（T）和异常（Throwable）都传进来。但它不自动分流，你得手动判空。

• 常见错误：忽略 throwable == null 判断，直接对 result 做非空操作，导致 NPE
• 性能影响：即使上游成功，handle 也必然执行，比单纯 thenApply 多一次函数调用开销，高并发下可感知
• 兼容性好：Java 8+ 全支持，不像 whenCompleteAsync 那样需注意线程池选择

future.handle((result, throwable) -> {
    if (throwable != null) {
        return fallbackByError(throwable); // 自定义降级逻辑
    }
    return validateAndWrap(result); // 正常路径处理
});

不要用 exceptionally 替代业务校验，否则会掩盖逻辑缺陷

很多同学把字段校验失败、HTTP 400 响应、数据库查不到记录这些本该走正常流程的 case，硬塞进异常流，再用 exceptionally 拦截——这会让错误语义混乱，调试时分不清是系统崩了还是业务没数据。

• HTTP 调用返回 404：应该解析响应体，走正常 thenApply 分支处理，而不是抛 RuntimeException 再进 exceptionally
• 数据库查询为空：用 Optional 作为返回类型，比抛 NoResultException 更符合语义
• 真正该进 exceptionally 的只有：连接 refused、JSON 解析失败、线程池满等不可控底层问题

handle 中 throw 异常会传播，exceptionally 中 throw 会吞掉异常

这是最易踩的坑：handle 方法体里如果抛出新异常，它会继续向下游传播（变成下一个 exceptionally 或 handle 的 throwable 参数）；而 exceptionally 里抛异常，CompletableFuture 会静默吞掉，下游收不到任何信号——看起来像“链路断了”，实际是异常被吃掉了。

• 排查技巧：如果发现某个 exceptionally 后面的 thenAccept 不执行，先检查这个 exceptionally 方法体里有没有意外抛异常
• 安全写法：在 exceptionally 里加 try-catch，或确保返回值构造绝对安全
• handle 更可控：你可以主动 throw，也可以返回特殊标记值，下游按需处理

异常恢复不是选语法糖，而是选语义——什么算“错”，什么算“空”，边界划清楚了，exceptionally 和 handle 才不会互相打架。

以上就是《JavaCompletableFuture异常处理：exceptionally与handle详解》的详细内容，更多关于的资料请关注golang学习网公众号！