外观
29 - Spring 定时任务:调度语义、重叠执行与集群边界
适用版本:Spring Framework 6.x、Spring Boot 3.x。Spring Framework 6.1 增强了调度能力;响应式
@Scheduled等新特性必须按目标小版本核验。本文主线讨论命令式方法调度。
摘要
给清理过期数据的方法加上 @Scheduled 后,应用可以按时间自动调用它。但方法执行得比周期长时,下一次何时开始?部署多个副本后,谁来执行?停机期间错过的任务是否需要补跑?这些问题不能仅靠一个注解回答。
@Scheduled 提供进程内的时间触发:调度器根据时间规则安排方法调用。它不天然提供集群唯一执行、失败重试、补偿、任务持久化和错过触发恢复。理解这条边界,需要先区分计划触发时间、实际开始时间和方法完成时间,再讨论容量与可靠性。
1. 从注册到触发
Bean 是由 Spring 容器管理的对象。要让方法按注解触发,需要先启用调度基础设施,例如通过 @EnableScheduling,并让目标对象成为容器 Bean。注解本身不会独立启动一个计时循环。
ScheduledAnnotationBeanPostProcessor 是负责识别调度注解的 Bean 后处理器,即在 Bean 初始化过程中参与处理的组件。它发现调度方法后,将任务交给调度基础设施,最终由 TaskScheduler(任务调度器)按时间规则调用方法:
text
Bean initialization → detect @Scheduled → register task
TaskScheduler → invoke method排查“任务没有执行”时,应沿这条链逐步检查:Bean 是否已注册,后处理器是否已启用,时间表达式是否成功解析,最终是否使用了预期调度器。手工构造的对象不经过容器处理;条件装配未满足时,目标 Bean 也可能根本没有注册。两者都可能让任务在触发之前就缺席。
1.1 源码调用链
text
ScheduledAnnotationBeanPostProcessor
→ postProcessAfterInitialization(...)
→ processScheduledTask(...)
→ ScheduledTaskRegistrar
→ TaskScheduler.schedule*(...)注解后处理器负责发现方法并建立任务描述,ScheduledTaskRegistrar 负责向调度器注册。这是一条用于理解职责的调用链,具体内部方法应按目标小版本定位。任务注册成功不代表执行成功:表达式解析决定时间规则能否建立,调度器选择决定任务交给谁,触发延迟表示实际开始晚于计划时间,目标方法异常则说明任务已开始但业务执行失败。这些阶段需要分别观察。
2. 三种时间语义
| 模式 | 下一次时间依据 | 适合场景 | 主要风险 |
|---|---|---|---|
fixedDelay | 上一次完成后再等待 | 不希望同一任务追赶执行 | 慢任务导致频率下降 |
fixedRate | 固定周期基准 | 周期采样、允许调度追赶 | 执行器拥塞、任务堆积 |
cron | 日历时间与时区 | 业务日历触发 | 夏令时、时区和错过触发 |
fixedDelay 从上一次方法完成后开始计时,因此执行耗时会拉长两次开始之间的间隔。fixedRate 以固定周期安排计划时间,方法执行变慢不会把它变成“完成后再等待”;实际调用可能因此晚于计划,并出现追赶执行。追赶指延迟后的调用间隔缩短,重叠则指前一次尚未完成,后一次已经开始,二者不是一回事。
不能把 fixedRate 理解为一定并发执行。是否重叠还受调度器实现、线程数、任务注册方式和方法是否把工作交给其他线程影响。尤其是方法提前返回、后台工作仍在进行时,“方法完成”不等于“业务工作完成”。应通过受控长任务测试实际并发度,而不是仅根据周期推断。
cron 是描述日历触发规则的表达式,例如在每天某个本地时间执行。它需要考虑 zone(时区),因为同一个本地时间在不同时区对应不同的时刻。DST(Daylight Saving Time,夏令时)切换还可能造成某个本地时间不存在或重复;具体触发结果取决于调度实现。跨地区业务应明确时区,并记录计划时间与实际开始时间。
3. 默认调度器不是容量设计
Spring 会按规则查找可用的 TaskScheduler 或调度执行器;Spring Boot 也可能自动配置。不要依赖“现在恰好只有一个线程”等隐式结果,应声明专用调度器并验证运行时配置。
Framework 的注解调度基础设施会优先解析容器中的调度器候选;没有可用候选时,可以创建本地单线程默认调度器。Boot 在自动配置条件成立时通常提供 ThreadPoolTaskScheduler 或相应构建器,并允许通过 spring.task.scheduling.* 一类属性配置。应用自定义相关 Bean 或配置类后,自动配置可能退让,即不再创建原本会提供的组件,因此必须检查实际 Bean,而不是只看配置文件。具体实现和条件需结合 Boot 小版本与运行配置判断。
以下是运行时诊断片段,需提供已初始化的应用上下文 context、日志对象 log 和 TaskScheduler 的导入。预期输出包含查到的调度器 Bean 名称及实现类型;它用于识别容器候选,还需结合任务注册配置确认实际选择:
java
context.getBeansOfType(TaskScheduler.class)
.forEach((name, scheduler) ->
log.info("scheduler name={}, type={}", name, scheduler.getClass()));线程数增加后,不同任务可以并发,但也会同时争抢数据库连接、HTTP 连接和锁。背压是下游处理不过来时,限制上游继续产生工作的机制。调度器队列只是保存待执行工作,不能自动判断数据库是否还能承受负载。因此,过载时还需要按业务选择跳过、合并、限流或暂停策略,避免等待中的工作持续增加。
4. 单机触发不等于集群唯一执行
应用副本是分别运行的应用实例。如果三个副本都启用同一调度配置,每个实例通常都会独立注册并触发任务:进程内调度器并不知道另外两个实例也在执行。若同一业务任务只允许由一个实例执行,就需要额外协调,或将触发工作交给外部系统:
- 数据库租约或悲观锁;
- Redis 等外部租约;
- Kubernetes CronJob;
- 支持持久化、分片和故障转移的任务平台。
租约是带有效期的执行权,用于避免持有者失联后任务永远无法接管。它也带来边界:旧实例暂停期间租约可能过期,新实例取得执行权后,旧实例又恢复运行。网络分区,即节点之间无法正常通信,也可能让协调状态与实际执行脱节。
因此,分布式锁只能约束进入执行区的资格,不能自动保证数据库写入、发消息等副作用只发生一次。任务应尽量幂等,即同一业务操作重复执行仍得到相同的业务结果;业务唯一键用于识别同一次操作,状态机则通过合法的状态转换约束重复处理。Kubernetes CronJob 或任务平台也需要结合自身的并发、重试和恢复策略设计,不能仅凭采用外部调度就认定副作用只发生一次。
5. 失败、重试与错过触发
时间规则只回答“何时尝试调用”,不回答“失败后如何完成业务”。普通内存调度不会自动把失败任务变成可靠作业;任务持久化是把任务状态和进度保存到进程之外,以便重启后恢复。设计时必须定义:
- 异常由谁记录和告警;
- 是否重试,退避(重试前等待并逐步拉长间隔)和最大次数是多少;
- 应用停机期间错过的触发是否补跑;
- 长任务跨过下一计划点时跳过、排队还是并发;
- 重复执行是否安全;
- 进度是否持久化,能否断点恢复。
数据库调用超时不一定意味着写入没有提交。如果在结果未知时直接重试,就可能重复写入。每次尝试应有清晰的事务边界,并利用幂等键或状态查询判断是否需要再次执行。业务失败、锁竞争和基础设施超时也应分别处理,因为它们的恢复条件不同。
6. 发布与关闭
滚动发布是逐批替换应用实例,新旧实例可能短暂同时存在,因此即使平时只有一个副本,发布过程中也可能出现重复触发。应用关闭时还要决定是否等待正在执行的任务,以及关闭宽限期,即允许任务收尾的时间,耗尽后如何恢复。
至少记录:任务名、计划触发时间、实际开始时间、实例 ID、执行序号、耗时、结果和幂等键。实际开始时间减去计划时间可以观察调度延迟,开始与结束之间的差值反映执行耗时;实例 ID 和幂等键帮助识别跨实例重复执行。只有“任务执行成功”这一条日志,无法判断延迟、漏跑和重复。
7. 最小验证方案
Trigger 是计算下一次执行时间的接口;闩锁 CountDownLatch 用于让线程等待某个事件发生。验证时先固定调度器实现和配置,再逐项观察:
- 对程序化
Trigger使用可控时钟;对注解任务使用短周期、闩锁和明确超时验证,避免长时间sleep; - 让任务执行时间超过周期,观察是否重叠或排队;
- 启动两个应用实例,验证是否重复执行;
- 在任务中途关闭实例,验证恢复策略;
- 注入一次失败,验证告警、重试和幂等;
- 同时监控调度延迟、执行耗时、活跃线程和下游资源。
下面是测试类中的局部片段,需补齐 CountDownLatch、AtomicInteger 的导入,以及 TimeUnit.SECONDS 的静态导入,并由测试代码安排调用 job()。片段本身不包含调度配置,也不构成完整测试。
第一次调用进入后会发出 firstEntered 信号,并等待 release,最多等待两秒。测试线程可用它观察等待期间是否有第二次调用进入:
java
CountDownLatch firstEntered = new CountDownLatch(1);
CountDownLatch release = new CountDownLatch(1);
AtomicInteger concurrent = new AtomicInteger();
AtomicInteger maxConcurrent = new AtomicInteger();
void job() throws InterruptedException {
int current = concurrent.incrementAndGet();
maxConcurrent.accumulateAndGet(current, Math::max);
firstEntered.countDown();
try {
release.await(2, SECONDS);
} finally {
concurrent.decrementAndGet();
}
}测试应先在明确超时内等待 firstEntered,再观察后续调用,并在清理阶段释放 release、停止调度器。测试周期和观察窗口需要保证第二次计划触发落在第一次等待期间,否则没有观察到重叠不能说明任务不会重叠。
预期观察:maxConcurrent > 1 表示方法调用发生过重叠;maxConcurrent == 1 只表示当前用例中未观察到重叠。测试完成后,应按所选调度器和配置的预期行为断言,并记录计划时间与实际开始时间。仅断言调用次数无法区分准时执行、积压后补执行和并发重叠。
运行时自检与关闭验证
ScheduledAnnotationBeanPostProcessor 实现了 ScheduledTaskHolder,后者提供读取已注册任务集合的接口。该集合适合确认注册事实,不应依赖任务对象的字符串格式作为长期监控协议。
关闭测试应在任务执行中触发应用上下文(Context)关闭,分别验证:是否等待已有任务、宽限期是否足够、未开始任务如何处理、外部租约何时释放。Boot 的等待关闭属性只影响其管理的执行器;自建调度器必须自行配置并纳入生命周期。
8. 总结
@Scheduled 提供的是进程内时间触发;可靠作业还需要持久化、幂等、集群协调、容量和恢复协议。
阅读导航
- Bean 与容器生命周期:05 - Bean 生命周期与扩展点顺序
- 执行器容量:并发 09 - ThreadPoolExecutor 参数与容量设计
- 任务关闭:并发 27 - 并发任务泄漏与进程无法退出
- 重试与退避:分布式 12 - 重试风暴与退避算法
- 幂等设计:分布式 13 - 幂等性与重复请求
- 滚动发布重叠窗口:云原生 18 - Deployment 无损滚动发布