handle方法是CompletableFuture中能同时处理成功结果和异常并返回任意类型新CompletableFuture的灵活方式，它接收结果和异常两个参数（必居其一非空），支持统一转换如封装为Result对象，且不吞异常，区别于whenComplete在于可改变返回值类型。
handle 方法是 CompletableFuture 中最灵活的异常与结果统一处理方式，它能同时捕获正常结果和异常，并返回任意类型的新 CompletableFuture。
handle 的核心特点
不同于 thenApply（只处理成功）或 exceptionally（只处理异常），handle 接收两个参数：
- 第一个参数是计算完成后的结果（成功时为实际值，失败时为 null）
- 第二个参数是抛出的异常（成功时为 null，失败时为具体异常对象）
二者必居其一为非空，因此可在同一个 lambda 中做分支判断并统一转换。
基础用法：统一包装成 Result 对象
常见场景是将异步结果统一转为封装类（如 Result<T>），便于上层消费：
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
if (Math.random() > 0.5) throw new RuntimeException("调用失败");
return "success";
});
<p>CompletableFuture<Result<String>> wrapped = future.handle((result, ex) -> {
if (ex == null) {
return Result.success(result);
} else {
return Result.failure(ex.getMessage());
}
});
注意 handle 不会吞异常：失败时仍会传播
handle 本身不会“吃掉”异常 —— 如果你在 lambda 中主动抛出新异常，或者对 ex 不做处理直接返回 null 或未覆盖逻辑，下游仍可能收到原始异常。稳妥做法是：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 显式判断
ex != null并返回兜底值（如默认对象、空 Optional、错误码封装） - 避免在 handle 内部再抛异常，除非有意让链路中断
- 若需记录日志，可在 handle 内直接写
log.error(..., ex)，不影响返回值
与 whenComplete 的区别：要不要改变返回值类型
whenComplete 也接收 (result, ex)，但它返回的是 CompletableFuture<Void>，不能改变类型或生成新结果；handle 则必须返回一个值（可为 null），且返回值类型由你指定，适合做有转换意图的统一处理。
立即学习“Java免费学习笔记（深入）”；
例如：把所有结果转成 JSON 字符串、转成 HTTP 响应体、映射为 DTO、或降级为缓存值 —— 这些都该用 handle。
