CompletableFuture.handle() 是 Java 8 提供的统一处理成功结果与异常的异步回调方法，接收 BiFunction 参数，成功时 data 非 null、ex 为 null，失败时反之，总是执行并返回新 CompletableFuture。
Java 中没有直接叫 handle 的内置方法能“同时处理成功结果与异常”，但你提到的很可能是 CompletableFuture.handle() —— 它是 Java 8 引入的、专门用于统一处理异步任务完成（无论成功或失败）的回调方法。
handle() 是 CompletableFuture 的核心容错处理方法
handle(BiFunction<t throwable r> fn)</t> 接收一个函数，该函数有两个参数：
– 第一个是正常执行返回的结果（成功时为实际值，失败时为 null）；
– 第二个是抛出的异常（成功时为 null，失败时为具体异常对象）。
它总是被执行，且返回一个新的 CompletableFuture<r></r>，适合做日志记录、兜底转换、统一响应封装等。
基本用法：用 null 判断区分成功/异常
示例：发起一个可能超时或出错的 HTTP 请求，统一返回格式：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
// 模拟可能失败的操作
if (Math.random() > 0.5) throw new RuntimeException("网络错误");
return "success-data";
});
CompletableFuture<Result<String>> handled = future.handle((data, ex) -> {
if (ex == null) {
return Result.success(data); // 成功：包装数据
} else {
return Result.failure("请求失败：" + ex.getMessage()); // 失败：统一错误信息
}
});
对比 thenApply / exceptionally：handle 更简洁统一
不用组合多个回调就能覆盖全路径：
立即学习“Java免费学习笔记（深入）”；
-
thenApply只在成功时调用，异常会被丢弃（除非后续加exceptionally） -
exceptionally只捕获异常，无法访问成功结果 -
handle二者兼顾，逻辑集中，避免重复写“兜底”逻辑
注意事项与技巧
– handle 中若再抛异常，会传播给下游（可被后续 exceptionally 或 handle 捕获）
– 返回值类型可与原 Future 不同（支持类型转换）
– 若需异步执行处理逻辑（比如发告警邮件），应配合 handleAsync 使用
– 不要忽略 ex 参数：即使只关心成功，也建议显式判断 if (ex != null) return fallback，防止静默失败
