SpringBoot-动态修改定时任务执行时间,实现改配置不重启服务

本文最后更新于:November 21, 2026 pm

目录

SpringBoot动态修改定时任务执行时间,实现改配置不重启服务。

引荐

在SpringBoot中实现定时任务,常规做法如下:

1
2
3
4
5
// 每10分钟执行一次
@Scheduled(cron = "0 */10 * * * ?")
public void cronOrder() {
....执行业务逻辑
}

注意:
SpringBoot中定时任务的cron表达式常规为6段(秒 分 时 日 月 周),而在Linux的cron中通常为5段(分 时 日 月 周)

这种常规的 cron 一旦写成注解参数,它就变成了代码的一部分。要改时间,就得重新编译、构建、发布、重启。对于修改频繁的任务来说,那简直是要命。
Spring中其实对于定时任务的注册有两种实现方式,而常规且用的最多的就是通过@Scheduled注解的方式使用;而另外一种就是今天主要说的
SchedulingConfigurer + CronTrigger的方式,用法也很简单,几行代码就可以实现。

动态定时任务

前沿

Spring 的定时任务体系里,真正管事的是 ScheduledTaskRegistrar 。注解只是把一个任务翻译注册到调度器里的入口之一。除了注解,Spring
还留了另一个口子:实现 SchedulingConfigurer 接口,重写 configureTasks(ScheduledTaskRegistrar taskRegistrar)
方法,在这个方法里手动注册任务。
ScheduledTaskRegistrar 提供了很多注册方法,但这里只说addTriggerTask(Runnable, Trigger) 。其中 Trigger
是动态化的关键:因为每次任务执行完成后,调度器都会向 Trigger 询问“下一次执行时间是多少”。如果我们让这个
Trigger 在每次回调时都去数据库读最新 cron,然后基于最新值计算下一次执行时间,那修改 cron 就不再需要碰代码了。

完整代码实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
@Configuration
@EnableScheduling
public class ScheduleTaskConfig implements SchedulingConfigurer {
private static final ZoneId CRON_ZONE = ZoneId.of("Asia/Shanghai");

@Resource
private TestDempService testDempService;

@Resource
private CronConfigMapper cronConfigMapper;

@Bean
public TaskScheduler taskScheduler() {
ThreadPoolTaskScheduler scheduler = new ThreadPoolTaskScheduler();
scheduler.setPoolSize(4);
scheduler.setThreadNamePrefix("schedule-task-");
scheduler.setWaitForTasksToCompleteOnShutdown(true);
scheduler.setAwaitTerminationSeconds(60);
return scheduler;
}

@Override
public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
taskRegistrar.setScheduler(taskScheduler());
taskRegistrar.addTriggerTask(
() -> testDempService.testCron(),
this::nextExecutionTime
);
}

private Instant nextExecutionTime(TriggerContext triggerContext) {
String cron = cronConfigMapper.getCron();
if (StringUtils.isBlank(cron)) { // 返回null表示不再调度 ,也可以写死固定一个兜底定时任务
return null;
}
CronTrigger trigger = new CronTrigger(cron, CRON_ZONE);
return trigger.nextExecution(triggerContext);
}
}

这样就实现了一个通过读取数据库中的配置动态调整定时任务的执行时间。

注意点

  • 修改 cron 后,已经排定的下一次执行不会被撤销。假设当前是 10:05,任务刚执行完,已经按旧 cron 把下一次排在了 10:10。你 10:06
    改了配置,10:10 还是会照常执行一次。真正按新 cron 运行,是从 10:10 这次执行完成之后才开始的。