外观
17 - FutureTask 与任务取消
适用 JDK:JDK 8+。
前置阅读:02 - Java 线程生命周期与正确中断方式、09 - ThreadPoolExecutor 参数与容量设计。
摘要
Future.cancel(true) 返回 true,任务为什么还在访问下游?因为“结果已取消”“线程收到中断请求”和“底层工作已停止”是三件事。本文先解释 Future 如何连接调用方与任务,再说明取消的边界、可退出任务的设计和排查方法。
1. Future 表示的是结果句柄
提交任务后,调用方与执行任务的线程可以各自继续运行。Future 是结果句柄,也就是调用方用来等待结果、查询状态或请求取消的对象;它不是执行线程本身。FutureTask 则把待执行的计算和这个结果句柄放在同一个对象中,既能作为任务运行,也能供调用方等待结果。
下面是调用方等待结果的局部片段,假定 executor 是执行器,load 是业务方法,Result 是业务结果类型;省略了导入和外围方法的异常声明:
java
Future<Result> future = executor.submit(this::load);
try {
return future.get(800, TimeUnit.MILLISECONDS);
} catch (TimeoutException e) {
future.cancel(true);
throw e;
}这里的 800 毫秒限制的是本次 get 的等待时间。超时后,get 抛出 TimeoutException,调用方进入 catch;执行任务的线程不会因此自动停止,所以片段另行调用 cancel(true) 请求取消。请求是否能让任务退出,仍取决于任务代码和底层资源是否支持取消。
2. cancel(true) 保证了什么
- 如果任务还没开始,成功取消后不应再执行。
- 如果任务已开始,参数
true表示允许尝试中断执行线程;它不是“等待线程停止”的指令。 - 返回
true表示取消成功,对调用方而言 Future 已被取消,不等于业务代码已停止。 - 中断是一种协作请求:任务需要检查中断标记,或通过可响应中断的阻塞操作退出。忽略标记的计算、不响应中断的 I/O(输入输出操作)不会被强制终止。
因此,取消请求可能已成功,但任务仍停留在一次下游调用中。只有下游调用返回或响应取消,业务代码才有机会继续执行退出和资源清理逻辑。cancel(false) 不请求中断,不能靠它要求已开始的业务代码停止;已提交的外部副作用也不会因任一种取消方式自动撤销。
3. FutureTask 的状态思路
当执行线程准备保存结果时,调用方可能同时请求取消。两者都要修改同一个结果句柄,因此 FutureTask 需要协调它们,避免同一次计算对外既表现为成功,又表现为取消。这里的“终态”指结果状态已经确定,不再转为另一种结果状态;它不表示底层工作和资源清理都已结束。
下面保留 OpenJDK FutureTask 的状态示意。COMPLETING 是保存结果或异常时的过渡状态,INTERRUPTING 是发出中断请求时的过渡状态。这些名称和字段数值属于实现细节,业务代码不应依赖它们:
图表将在阅读到此处时加载…
阅读这个图时有两个边界:NEW 不应简单理解为“业务代码尚未开始”,图中的“未运行时取消”只展示了一个取消场景,不是 cancel(false) 的全部适用条件;INTERRUPTED 表示中断请求阶段完成,不表示执行线程已经退出。cancel(false) 与正常完成竞争时,也只有成功完成状态转换的一方生效。
4. 可取消任务的设计
任务应同时考虑两种退出原因:调用方请求取消,以及任务自己的时间预算耗尽。Deadline(截止时间)给出整个任务最迟应结束的时间;每次执行一步工作前,都根据剩余时间决定还能等待多久。
下面是业务流程示意,Deadline、Result 和 tryOneStep 均为业务自定义类型或方法,并非 JDK API。保留原片段的控制流程;它不是可直接编译的完整示例:末尾抛出的 TimeoutException 是受检异常,实际代码还需在方法签名声明或在内部处理。
java
Result load(Deadline deadline) throws InterruptedException {
while (!deadline.expired()) {
if (Thread.currentThread().isInterrupted()) {
throw new InterruptedException("cancelled");
}
Result result = tryOneStep(deadline.remaining());
if (result != null) return result;
}
throw new TimeoutException("deadline exceeded");
}循环每轮先检查剩余预算,再检查中断标记,最后执行一步工作。这种“可退出点”让任务能在明确的边界停止,而不必在每行代码中检查中断。
不过,如果 tryOneStep 长时间不返回,下一轮检查就没有机会执行。因此,传入剩余时间还不够,底层客户端必须实际使用这一预算,并配置连接、读取和总超时。退出路径也要释放任务持有的资源;Future 的取消状态本身不会代替资源清理。
5. 取消后的副作用
副作用是任务对外部状态产生的改变,例如数据库写入、消息发送或远程请求。取消只能影响后续工作,之前已完成的操作不会自动撤销;调用方没拿到结果,也不能据此判断外部操作没有成功。
因此,重试前需要明确业务策略:幂等键用于识别重复请求,避免同一操作重复生效;事务边界规定哪些修改可以一起提交或回滚;补偿策略则处理无法直接回滚的已完成操作。它们解决的是外部状态一致性,不能用一次 cancel 调用替代。
6. execute() 与 submit() 的故障差异
在线程池使用中,execute() 不向调用方返回 Future;submit() 返回 Future,并将任务异常保存在其中,供调用方通过 get() 观察。如果调用方丢弃这个句柄,就失去了通过它取消任务和读取失败原因的入口。线程池的异常语义见 09 - ThreadPoolExecutor 参数与容量设计。
下面仍是局部片段,translate 代表将任务异常转换为业务异常的方法,外围方法和导入未展示:
java
try {
return future.get();
} catch (ExecutionException e) {
Throwable cause = e.getCause();
throw translate(cause);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
throw e;
}ExecutionException 表示任务已经异常结束,getCause() 才是任务抛出的原始异常。InterruptedException 表示当前等待线程被中断,并不能据此判断任务已经失败或停止;片段恢复当前线程的中断标记后继续抛出异常,让上层处理这一请求。两者不应合并成同一种业务失败。
Future 已取消时,get() 会抛出 CancellationException。它是未检查异常,不要求写在方法的 throws 声明中,但业务仍应把取消作为独立结果处理;上面的片段没有单独捕获它。
6.1 完成、超时与取消竞态
竞态指多个线程的操作先后顺序会影响结果。调用方等待超时时,任务可能正好同时完成,所以随后的 cancel(true) 不一定成功。返回 false 可能表示任务已经完成或已被其他线程取消,不能把它统一理解为“任务还在运行”。调用方应根据业务决定是否再读取最终状态,而不是直接重复提交一个可能产生副作用的任务。
取消共享 Future 还会影响其他等待者。SingleFlight 是把针对同一目标的并发请求合并为一次实际任务、让多个调用方共享结果的模型。此时单个等待者超时通常只应停止自己的等待,否则它的取消会影响仍需要结果的调用方。详见 30 - 单机请求合并与 SingleFlight。
7. 验证与排障
下面是测试与观测建议,不是本文已执行的实验记录。排查时分别观察调用方、Future 状态和底层工作,才能定位取消停在哪一层:
- 测试任务未开始、正在计算、正在可中断阻塞三种时机。
- 记录取消请求时间、Future 进入终态时间和底层资源真正释放时间。
- 检查超时后队列是否仍有过期任务,下游请求数是否继续增长。
- 构造“完成与 cancel 同时发生”的竞态,断言只出现一个合法终态。
- 使用 A - Java 并发代码测试方法的故障注入覆盖中断和关闭路径。
8. 总结
设计取消流程时,先区分调用方不再等待、Future 已取消和任务实际退出,再把时间预算、中断响应、资源清理与外部副作用处理连接起来。这样才能解释“取消成功但下游仍在工作”,并为每一层设置可观察的退出条件。
本文仅经静态审阅,未运行代码或独立核验 JDK 文档、源码;状态图和 API 说明仍需结合目标 JDK 核对,尤其不能用状态名称推断执行线程是否已经停止。
故障排查:27 - 并发任务泄漏与进程无法退出检查 Future 被丢弃、取消未传播和执行器关闭失败。