whenComplete 是 CompletableFuture 中用于最终消费结果或异常的方法，不改变原始结果，只执行副作用操作；接收 BiConsumer<T, Throwable>，无论成功或失败均执行，返回原 CompletableFuture 以支持链式调用。
whenComplete 是 CompletableFuture 中用于“最终消费结果或异常”的关键方法，它不改变原始任务的结果，只负责观察和响应——适合日志记录、资源清理、UI 更新等副作用操作。
它怎么工作？
- 接收一个
BiConsumer<T, Throwable>：第一个参数是成功时的结果（可能为null），第二个参数是失败时的异常（也可能为null），二者必居其一。 - 无论任务成功或抛出异常，回调都会执行。
- 返回值仍是原
CompletableFuture<T>，可继续链式调用其他方法（比如再接thenApply或join）。
常见使用场景与写法
- 记录执行完成状态（含成功/失败）
- 清理临时资源（如关闭数据库连接、释放锁）
- 向监控系统上报耗时或状态
- 更新前端 UI 的 loading 状态
基础写法示例
立即学习“Java免费学习笔记（深入）”；
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
CompletableFuture<String> future = CompletableFuture.supplyAsync(() -> {
// 模拟可能失败的远程调用
if (Math.random() > 0.5) throw new RuntimeException("网络超时");
return "data";
});
future.whenComplete((result, ex) -> {
if (ex != null) {
System.err.println("任务失败：" + ex.getMessage());
} else {
System.out.println("任务成功，结果：" + result);
}
});注意线程执行归属
- 如果注册
whenComplete时任务尚未完成，回调由执行该任务的线程（比如线程池中的某个 worker）顺带执行； - 如果注册时任务已经完成，回调由当前线程（即调用
whenComplete的线程）执行。
这可能导致意外的同步阻塞（比如在主线程里触发耗时清理逻辑）。避免方式：
- 改用
whenCompleteAsync(BiConsumer)→ 回调交由ForkJoinPool.commonPool()执行 - 或更稳妥地：
whenCompleteAsync(BiConsumer, executor)→ 指定自定义线程池（推荐）
和 handle / exceptionally 的区别
-
whenComplete：只消费，不返回新值，不改变后续结果流； -
handle：也接收(result, ex)，但必须返回一个值（可为null），会生成新的CompletableFuture； -
exceptionally：只在异常时触发，且只接收Throwable，用于提供兜底值。
所以，如果你只是想“看一眼结果或异常，然后做点事”，whenComplete 就是最轻量、最直接的选择。
