handle是CompletableFuture中唯一能同时处理正常结果和异常的回调方法，通过BiFunction接收result（失败时为null）和ex（成功时为null），必须返回统一类型值，适用于结果标准化与降级封装。
handle 是 CompletableFuture 中最实用的“兜底式”回调方法，它能同时捕获正常结果和异常，避免 thenApply（只处理成功）与 exceptionally（只处理异常）分开写导致逻辑割裂或遗漏。
handle 的签名和核心特点
它的函数式接口是：public <U> CompletableFuture<U> handle(BiFunction<T, Throwable, U> fn)
关键点：
- 接收两个参数：第一个是上一阶段的正常结果（成功时为实际值，失败时为
null），第二个是抛出的异常（成功时为null） - 必须返回一个值（不能为 void），该值成为新 CompletableFuture 的结果
- 无论上一阶段是完成还是异常完成，
handle都会执行 —— 这是它和whenComplete（返回 void，不改变结果）的本质区别
统一转换结果与降级逻辑（推荐用法）
适合需要把原始结果、异常都映射成同一类型（如统一返回 Result<T> 包装类）的场景：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
if (Math.random() > 0.5) throw new RuntimeException("服务暂时不可用");
return "data";
});
CompletableFuture<Result<String>> resultFuture = future.handle((data, ex) -> {
if (ex == null) {
return Result.success(data);
} else {
// 统一降级：记录日志 + 返回默认值或错误包装
System.err.println("调用失败：" + ex.getMessage());
return Result.failure("fallback", ex);
}
});
避免空指针：注意 null 安全性
因为成功时 ex 为 null，异常时 data 为 null，直接解包可能 NPE：
立即学习“Java免费学习笔记（深入）”；
- ❌ 错误写法：
data.length()（异常时 data 是 null） - ✅ 正确做法：先判空，或用 Optional 封装，或依赖业务约定（如用特殊值标记异常态）
- 建议在 handle 内部做防御性检查，不要假设 data 或 ex 一定非空
与 exceptionally / whenComplete 的对比选择
什么时候不用 handle？
- 只需纯副作用（如打日志、发告警），不改变结果 → 用
whenComplete - 只关心异常且想返回默认值（不处理正常结果）→
exceptionally更简洁 - 需要严格区分成功/失败路径，且逻辑复杂 → 拆成
thenApply+exceptionally更易读 - 但大多数 API 封装、结果标准化、熔断降级场景，
handle更紧凑、不易漏分支
handle 不是万能，但它让“有始有终”的异步处理变得更可控 —— 一次声明，两种终点，结果可续。
