外观
20 - ScheduledThreadPoolExecutor 与定时任务
适用 JDK:JDK 8+。涉及容器或分布式部署时,不能把进程内调度等同于可靠任务系统。
前置阅读:02 - Java 线程生命周期与正确中断方式、09 - ThreadPoolExecutor 参数与容量设计。
摘要
定时任务到了约定时间,为什么还没开始?昨天还在周期执行,为什么今天停了?理解这些问题,先要分清“任务到期”和“任务执行”:到期表示任务可以开始执行,实际开始还要等调度池有可用线程。
ScheduledExecutorService 是 Java 的调度执行器接口,支持一次性延迟任务和重复执行的周期任务;ScheduledThreadPoolExecutor 是它的线程池实现。任务及其调度状态保存在进程内,由工作线程执行。它解决的是何时允许执行,不保证准点完成,也不负责进程重启后的任务恢复或多个实例之间的协调。
下面先说明两种周期语义,再讨论异常、取消、时钟和可靠性边界。
1. 固定频率与固定延迟
下面是局部业务片段,假定当前对象已有 collect 和 cleanup 方法,相关类型来自 java.util.concurrent。导入、外围类和线程池关闭逻辑未展示,不是可直接运行的完整程序:
java
ScheduledExecutorService scheduler =
Executors.newScheduledThreadPool(2);
scheduler.scheduleAtFixedRate(this::collect, 0, 10, TimeUnit.SECONDS);
scheduler.scheduleWithFixedDelay(this::cleanup, 0, 10, TimeUnit.SECONDS);两次提交都把首次执行的等待时间设为 0,后面的 10 分别表示周期或执行间隔,单位是秒。这些是示例参数,不是实测得到的配置建议。
scheduleAtFixedRate表达固定频率:以首次计划开始时间为基准,后续计划时间每次增加一个周期。它适合表达节拍,例如希望每隔一段时间采集一次数据。scheduleWithFixedDelay表达固定延迟:上一次执行结束后,再等待指定时间才执行下一次。它适合两次执行之间必须留出间隔的场景,例如清理完成后等待一段时间再清理。
假设一次执行耗时 3 秒、周期或间隔均为 10 秒,且没有线程等待等额外延迟:固定频率的计划开始时间相隔 10 秒;固定延迟则在结束后再等 10 秒,两次开始时间相隔约 13 秒。这只是说明时间语义的假设例子,不是运行记录。
同一次周期提交的多次执行不会互相重叠。 固定频率任务执行过慢时,后续运行会延迟,而不是通过并发执行同一个周期任务来追上计划。这个保证针对一次周期提交,不能用来阻止另一次提交或另一个进程执行相同业务。
不同任务仍会竞争调度池线程。单线程调度池中,某个任务长时间阻塞时,其他任务即使已经到期也只能等待;多个线程全部被占用时也有同样的问题。因此,两种方法都不保证严格按时启动。GC(垃圾回收)、CPU 饱和、锁等待和线程池容量,都可能让实际开始时间偏离计划时间,这种偏离称为启动漂移。
2. 未捕获异常会停止后续周期执行
周期任务某次执行向外抛出异常后,后续执行会被抑制,也就是不再继续调度。它与“线程池忙,任务暂时没开始”不同:前者已经停止这个周期任务,后者仍在等待执行。
提交调度任务时返回的 ScheduledFuture 是任务句柄,可用于取消任务和观察其状态。如果既没有保留句柄,也没有记录异常,业务上看到的可能只是“任务消失”。
下面是记录执行结果的局部包装片段,假定已有 runOnce、指标对象 metrics 和日志对象 log。这里只定义了 guarded,实际提交调度、导入和外围实现未展示:
java
Runnable guarded = () -> {
long startedAt = System.nanoTime();
try {
runOnce();
metrics.recordSuccess();
} catch (Throwable t) {
metrics.recordFailure(t);
log.error("scheduled task failed", t);
} finally {
metrics.recordRunTime(System.nanoTime() - startedAt);
}
};包装器在业务执行失败时记录失败和日志,并在 finally 中记录本次耗时。捕获异常后正常返回,才不会因该异常向调度器传播而停止后续周期;指标或日志代码若再次向外抛出异常,这个包装也不能保证周期继续。
Throwable 同时包含通常需要处理的异常和 Error 一类严重错误。是否捕获 Error、捕获后是否继续运行,需要结合进程故障策略决定;示例强调失败必须能被观察到,不代表所有严重错误都应继续调度。
这里用 System.nanoTime() 的差值记录耗时,不是记录日历时间。启动延迟应由调度包装器根据计划触发时间与实际开始时间另行记录:运行很快的任务,也可能已经晚了很久才开始。
3. 取消与队列清理
取消需要分清两个问题:停止后续调度,以及让当前执行尽快结束。对正在运行的任务调用 ScheduledFuture.cancel(true) 会请求中断执行线程;中断是协作信号,任务若忽略中断或底层 I/O(输入输出操作)没有超时,取消不能保证立即结束。有关任务能否响应中断,应结合前置文章中的中断处理方式检查。
取消后还要关注等待队列。大量远期任务被取消时,若仍留在队列中等待到期,就会继续占用内存。可对 ScheduledThreadPoolExecutor 启用 setRemoveOnCancelPolicy(true),让已取消任务及时从工作队列移除。该策略改变的是队列清理时机,不是强制终止正在运行的代码;应在所支持 JDK 上验证其内存和清理效果。
线程池关闭时,还需明确如何处理已提交的任务。ScheduledThreadPoolExecutor 默认会在 shutdown() 后继续执行已经提交的延迟任务,但不会继续周期任务。可分别通过以下关闭策略(shutdown policy)明确配置业务要求:
setExecuteExistingDelayedTasksAfterShutdownPolicy:关闭后是否执行已存在的延迟任务。setContinueExistingPeriodicTasksAfterShutdownPolicy:关闭后是否继续已存在的周期任务。
不要只用默认值表达业务语义。无论采用哪种策略,都应在目标 JDK 上测试关闭与任务到期、执行同时发生的情况,即关闭竞态,确认剩余任务的处理和进程退出符合预期。这里是验证建议,不是本文已执行的测试记录。
4. 时钟、漂移与补偿
“再等 10 秒”与“每天北京时间 02:00”是两种要求。前者关注相对等待时间,后者关注日历上的具体时刻。日历任务还涉及时区、夏令时、系统时钟校正,以及错过触发时间后的处理。
ScheduledExecutorService 接收的是相对延迟。需要按墙上时钟(日历日期和时间)执行时,应计算下一次日历时刻与当前时刻的差值,并在每次完成后重新计算下一次安排。不要假定一次固定周期调度会自动处理时区规则、夏令时切换或人工校时;日历时间计算与时钟变化仍需单独设计。
业务应记录计划时间、实际开始时间、完成时间和本次执行标识。计划时间与实际开始时间用于观察启动延迟,实际开始时间与完成时间用于观察运行耗时,执行标识用于关联同一次执行的记录。只记录耗时无法发现“晚了十分钟才开始”。
错过计划时间后,还要选择 misfire(错过触发)策略:立即补跑、只补一次、逐次补齐,或直接跳到下一周期。对账和结算任务可能需要处理遗漏的业务周期,缓存清理则可能只需完成当前清理;应按业务要求选择,不能把所有任务都设成同一种补偿方式。
5. 多实例与可靠性边界
应用扩容到三个实例后,如果每个实例都注册同一任务,各自的本地调度器通常都会执行它。单个周期任务不重叠的保证只在本次提交内成立,不能保证集群中只有一个实例执行。
若要求全局只执行一次,需要租约、分布式锁、数据库抢占或专用调度系统来协调。租约是有有效期限的执行资格,数据库抢占则是通过数据库状态竞争任务的执行权。协调机制仍需处理锁或租约过期、进程暂停等情况,不能仅凭“拿到锁”就认为不会重复产生业务效果。
进程崩溃还会丢失内存中的一次性延迟任务。ScheduledFuture 只是进程内任务句柄,不是持久任务记录。要求重启后恢复、审计、重试或补偿时,应将任务状态持久化,让恢复逻辑能判断哪些任务待执行、已完成或需要重试。
这里需要区分三个目标:
- 最多一次:允许不执行,但不重复执行。
- 至少一次:要求执行,允许因重试等原因重复执行。
- 恰好一次业务效果:即使重复触发,也只产生一次应有的业务结果。
分布式调度通常仍可能重复触发,最终效果依赖幂等键、状态机或事务边界。幂等指同一业务操作重复处理时,不重复产生不应发生的效果;幂等键用于识别同一操作,状态机约束任务可以如何改变状态,事务边界决定哪些操作一起成功或失败。这些设计需要与具体业务写入配合,不能由本地调度器代替。幂等键与重复请求处理见 分布式 13 - 幂等性与重复请求。
6. 排障清单
先区分任务已经停止、到期后仍在等待,还是执行结果不符合预期,再按下面的线索检查:
- 检查最后一次成功、失败、计划时间和实际开始时间,不只看日志是否出现。
- 检查周期任务是否曾向外抛出未捕获异常,以及任务句柄的状态。
- 对照调度线程栈、CPU、GC、锁和下游延迟,检查是否有长任务占满全部工作线程。
- 检查工作队列中的延迟任务数,以及大量取消任务是否仍然滞留。
- 多实例场景确认是重复执行、没有实例持有租约,还是重复执行产生了未被幂等设计阻止的业务效果。
- 核对时区、系统时钟和错过执行后的补偿规则。
7. 总结
ScheduledThreadPoolExecutor 提供进程内延迟执行,不提供持久化、集群唯一性或业务恰好一次。 使用时先确定时间语义,再安排失败、取消和恢复策略:
- 固定频率按计划节拍安排,固定延迟从上次结束后计算间隔;到期不等于立即开始。
- 分别观察异常、启动延迟和运行耗时,并明确取消与关闭时如何处理剩余任务。
- 需要可靠的分布式任务时,另行设计持久状态、租约与幂等处理。
本文仅完成文本改写和静态自查,未编译或运行示例,也未独立核验 JDK 文档或源码。具体 API 契约、关闭行为及并发边界仍需结合目标 JDK 核对。
故障排查:27 - 并发任务泄漏与进程无法退出覆盖取消任务滞留、调度线程未关闭和退出超时。