thenRun用于前序任务成功完成后立即执行无参无返回值的Runnable动作,适用于日志、通知等无需结果的收尾操作,不处理异常且默认同线程执行。

thenRun 是 CompletableFuture 提供的“无参无返回值”回调方法,用于在前序任务**成功完成**后,**立即执行一个 Runnable 动作**,不依赖前序结果,也不影响后续链式调用的返回值。
什么时候该用 thenRun?
当你只需要“做点事”,比如记录日志、发通知、清理资源,且不需要前一个任务的结果,也不需要把当前动作的结果传给下游时,thenRun 最简洁合适。
- 前序任务是
supplyAsync或runAsync,但你只关心“它跑完了”,不关心返回值 - 后续还要接
thenApply/thenCompose等需要返回值的方法,不能破坏链式结构 - 不想引入额外变量或副作用逻辑到主线程处理流中
基本写法和注意事项
语法很简单:future.thenRun(() -> { /* 你的动作 */ });
- 它**不会等待**前序任务的异常 —— 如果前序抛出异常,thenRun 不会执行
- 它默认在前序任务完成的**同一线程**(或线程池)中执行(除非显式用
thenRunAsync指定其他线程池) - 它不接收参数,所以无法直接拿到前序
supplyAsync的返回值;若需结果,请改用thenAccept
对比几个常用类似方法
避免混淆,关键区别如下:
- thenRun:无参、无返回值,仅“执行动作”
- thenAccept:接收前序结果(1个参数),无返回值
- thenApply:接收前序结果,必须返回新值,用于转换
- thenRunAsync:行为同 thenRun,但强制异步执行(走默认 ForkJoinPool 或指定线程池)
一个小例子
假设异步查用户,查完后发个内部审计日志:
CompletableFuture<user> userFuture = CompletableFuture.supplyAsync(() -> userDao.findById(123));
<p>userFuture
.thenRun(() -> System.out.println("✅ 用户查询已完成"))
.thenAccept(user -> System.out.println("? 用户名:" + user.getName()))
.exceptionally(ex -> {
System.err.println("❌ 查询失败:" + ex.getMessage());
return null;
});
</p></user>
注意:第一行 thenRun 打印不依赖 User 对象,第二行 thenAccept 才真正用到结果 —— 这种分工让逻辑更清晰。
不复杂但容易忽略:别指望 thenRun 能捕获异常或传递数据,它就只是安静地“收尾”。需要更多能力,就换对应语义的方法。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











