Spring Boot系列三 Spring @EnableScheduling 定时任务用法总结

最新推荐文章于 2025-06-23 18:28:53 发布

原创

最新推荐文章于 2025-06-23 18:28:53 发布 · 1.4w 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#spring #Scheduled

本文详细介绍了Spring Boot中使用@Scheduled进行定时任务的原理，包括TaskScheduler的两种实现方式TimerManagerTaskScheduler和ThreadPoolTaskScheduler，以及Trigger在配置任务执行时间中的作用。此外，还讲解了@Scheduled注解的使用方法，如fixedDelay、fixedRate、initialDelay和cron表达式，并提供了启动定时任务的不同方式，包括注解和XML配置。最后提到了如何自定义配置线程池。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. 原理

1.1 TaskScheduler

TaskScheduler是spring的定时任务使用的线程池的关键类

public interface TaskScheduler {
    // 通过Trigger执行任务
    ScheduledFuture schedule(Runnable task, Trigger trigger);
// 指定时间执行任务
    ScheduledFuture schedule(Runnable task, Date startTime);
// 指定在指定时间后，循环周期执行任务
    ScheduledFuture scheduleAtFixedRate(Runnable task, Date startTime, long period);
    //  循环周期执行任务
    ScheduledFuture scheduleAtFixedRate(Runnable task, long period);
    // 延迟N时间，在指定日期执行
    ScheduledFuture scheduleWithFixedDelay(Runnable task, Date startTime, long delay);
    ScheduledFuture scheduleWithFixedDelay(Runnable task, long delay);
}

TaskScheduler有两种实现方式：
- TimerManagerTaskScheduler：使用外部对象管理线程池，如 CommonJ TimerManager，适用于多个进程共享线程池
- ThreadPoolTaskScheduler：如果仅仅在同一进程管理线程池，则推荐使用此对象。它实际使用Java自我的ScheduledExecutorService管理线程池

1.2 Trigger

Trigger是定时任务配置的关键类，配置方法的下次执行时间

public interface Trigger {
    Date nextExecutionTime(TriggerContext triggerContext);
}

方法里的参数TriggerContext是封装了任务最后执行的时间和最后执行完毕的时间

public interface TriggerContext {
    Date lastScheduledExecutionTime();
    Date lastActualExecutionTime();
    Date lastCompletionTime();
}

TriggerContext默认的实现是SimpleTriggerContext，看源码实现非常简单

Trigger的实现类：
- CronTrigger：使用cron表达式定义任务执行时机
如：scheduler.schedule(task, new CronTrigger("0 15 9-17 * * MON-FRI"));
- PeriodicTrigger：通过“fixed period,”，“initial delay value”，“boolean to indicate whether the period should be interpreted as a fixed-rate or a fixed-delay”3个参数配置任务执行的时机