Spring Boot 使用 @Scheduled 注解创建定时任务

在项目开发中我们经常需要一些定时任务来处理一些特殊的任务，比如定时检查订单的状态、定时同步数据等等。

在 Spring Boot 中使用 @Scheduled 注解创建定时任务非常简单，只需要两步操作就可以创建一个定时任务：

1、在定时任务类上增加 @EnableScheduling 注解

2、在要执行任务的方法上增加 @Scheduled 注解

下面是我使用 cron 表达式创建一个简单的定时任务：

import java.text.SimpleDateFormat;
import java.util.Date;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
// 启用定时任务
@EnableScheduling
public class ScheduledTasks {

    private static final Logger log = LoggerFactory.getLogger(ScheduledTasks.class);

    private static final SimpleDateFormat dateFormat = new SimpleDateFormat("HH:mm:ss");

    // 每 5 秒执行一次任务。
    @Scheduled(cron = "0/5 * * * * ?")
    public void performingTasks() {
        log.info("执行定时任务时间：{}", dateFormat.format(new Date()));
    }
}

启动运行项目以后控制台会每隔五秒打印一条记录。

2019-07-25 11:12:00.343  INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks      : 执行定时任务时间：11:12:00
2019-07-25 11:12:05.343  INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks      : 执行定时任务时间：11:12:05
2019-07-25 11:12:10.343  INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks      : 执行定时任务时间：11:12:10
2019-07-25 11:12:15.343  INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks      : 执行定时任务时间：11:12:15
2019-07-25 11:12:20.343  INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks      : 执行定时任务时间：11:12:20
2019-07-25 11:12:25.342  INFO 15988 --- [pool-1-thread-1] c.m.s.s.a.controller.ScheduledTasks      : 执行定时任务时间：11:12:25

一些常用的 Cron 表达式例子

表达式	说明
0/2 * * * * ?	表示每 2 秒执行任务
0 0/2 * * * ?	表示每 2 分钟执行任务
0 0 2 1 * ?	表示在每月的 1 日的凌晨 2 点调整任务
0 15 10 ? * MON-FRI	表示周一到周五每天上午 10:15 执行作业
0 15 10 ? 6L 2002-2006	表示 2002-2006 年的每个月的最后一个星期五上午 10:15 执行作
0 0 10,14,16 * * ?	每天上午 10 点，下午 2 点，4 点
0 0/30 9-17 * * ?	朝九晚五工作时间内每半小时
0 0 12 ? * WED	表示每个星期三中午 12 点
0 0 12 * * ?	每天中午 12 点触发
0 15 10 ? * *	每天上午 10:15 触发
0 15 10 * * ?	每天上午 10:15 触发
0 15 10 * * ?	每天上午 10:15 触发
0 15 10 * * ? 2005	2005 年的每天上午 10:15 触发
0 * 14 * * ?	在每天下午 2 点到下午 2:59 期间的每 1 分钟触发
0 0/5 14 * * ?	在每天下午 2 点到下午 2:55 期间的每 5 分钟触发
0 0/5 14,18 * * ?	在每天下午 2 点到 2:55 期间和下午 6 点到 6:55 期间的每 5 分钟触发
0 0-5 14 * * ?	在每天下午 2 点到下午 2:05 期间的每 1 分钟触发
0 10,44 14 ? 3 WED	每年三月的星期三的下午 2:10 和 2:44 触发
0 15 10 ? * MON-FRI	周一至周五的上午 10:15 触发
0 15 10 15 * ?	每月 15 日上午 10:15 触发
0 15 10 L * ?	每月最后一日的上午 10:15 触发
0 15 10 ? * 6L	每月的最后一个星期五上午 10:15 触发
0 15 10 ? * 6L 2002-2005	2002 年至 2005 年的每月的最后一个星期五上午 10:15 触发
0 15 10 ? * 6#3	每月的第三个星期五上午 10:15 触发

@Scheduled 除了支持 cron 表达式以外还有很多的其他使用方法：

// 上一次开始执行时间点后 1 秒再次执行。
@Scheduled(fixedRate = 1000)

// 上一次执行完毕时间点后 1 秒再次执行。
@Scheduled(fixedDelay = 1000)

// 第一次延迟 2 秒执行，然后在上一次执行完毕时间点后 1 秒再次执行。
@Scheduled(initialDelay = 2000, fixedDelay = 1000)

网上也有一些 Cron 测试工具可以验证定时任务的执行时间：

1、https://tool.lu/crontab/

2、http://cron.qqe2.com/