Spring Boot 集成 Quartz 实现定时任务（Cron 表达式示例）
Spring Boot 集成 Quartz 实现定时任务（Cron 表达式示例）
前言
在 Spring Boot 项目中，我们经常需要定时执行某些任务，例如定期清理数据库、同步数据、发送通知等。Quartz 是一个强大的任务调度框架，可以通过 Cron 表达式 实现灵活的任务调度。本篇文章将介绍如何在 Spring Boot 中集成 Quartz 并使用 Cron 表达式 进行任务调度。
1. 添加 Quartz 依赖
在 Spring Boot 项目中，首先需要引入 Quartz 相关依赖。
如果使用 Maven，在 pom.xml 中添加以下依赖：
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-quartz</artifactId></dependency>如果使用 Gradle，则添加：
implementation 'org.springframework.boot:spring-boot-starter-quartz' 2. 创建 Quartz 任务
在 Quartz 中，每个定时任务需要继承 org.quartz.Job 接口，并实现 execute 方法。
importorg.quartz.Job;importorg.quartz.JobExecutionContext;importorg.quartz.JobExecutionException;importjava.time.LocalDateTime;publicclassMyQuartzJobimplementsJob{@Overridepublicvoidexecute(JobExecutionContext context)throwsJobExecutionException{System.out.println("Quartz 定时任务执行中："+LocalDateTime.now());}}3. 配置 Quartz 任务调度
Spring Boot 允许通过 SchedulerFactoryBean 配置 Quartz 任务，并使用 @Bean 方式定义任务的调度规则。
importorg.quartz.*;importorg.springframework.context.annotation.Bean;importorg.springframework.context.annotation.Configuration;@ConfigurationpublicclassQuartzConfig{// 定义 JobDetail@BeanpublicJobDetailmyJobDetail(){returnJobBuilder.newJob(MyQuartzJob.class).withIdentity("myQuartzJob")// 任务名称.storeDurably().build();}// 定义触发器，使用 Cron 表达式@BeanpublicTriggermyJobTrigger(){returnTriggerBuilder.newTrigger().forJob(myJobDetail()).withIdentity("myQuartzTrigger")// 触发器名称.withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 0-7 ? * * *"))// Cron 表达式.build();}}在上述配置中，我们的定时任务：
- 每 5 分钟执行一次
- 每天从 00:00 到 07:59 之间执行
- 使用 Cron 表达式
0 0/5 0-7 ? * * *
如果需要 08:00 也执行一次，可以修改 Cron 表达式为：
0 0/5 0-8 ? * * * 4. 启动 Spring Boot 观察定时任务执行
启动 Spring Boot 项目，观察控制台输出：
Quartz 定时任务执行中：2024-03-19T00:00:00 Quartz 定时任务执行中：2024-03-19T00:05:00 Quartz 定时任务执行中：2024-03-19T00:10:00 ... Quartz 定时任务执行中：2024-03-19T07:55:00 如果 Cron 表达式修改为 0 0/5 0-8 ? * * *，则会多执行一次：
Quartz 定时任务执行中：2024-03-19T08:00:00 5. Quartz Cron 表达式详解
Quartz 的 Cron 表达式有 7 个字段，每个字段的含义如下：
| 字段 | 允许值 | 说明 |
|---|---|---|
| 秒（Seconds） | 0-59 | 任务触发的秒数 |
| 分（Minutes） | 0-59 | 任务触发的分钟数 |
| 小时（Hours） | 0-23 | 任务触发的小时数 |
| 日期（Day of month） | 1-31 | 任务触发的日期（不能与 Day of week 同时指定） |
| 月份（Month） | 1-12 或 JAN-DEC | 任务触发的月份 |
| 星期（Day of week） | 1-7 或 SUN-SAT | 任务触发的星期几 |
| 年（可选） | 空 或 1970-2099 | 任务触发的年份 |
示例 Cron 表达式：
0 0 12 * * ?→ 每天中午 12:00 执行0 0/30 * * * ?→ 每 30 分钟执行一次0 15 10 * * ?→ 每天 10:15 执行0 0 8-20/2 * * ?→ 每天 08:00 - 20:00 之间，每 2 小时执行一次
6. 结论
本篇文章介绍了如何在 Spring Boot 中集成 Quartz 进行定时任务调度，并通过 Cron 表达式 控制任务执行时间。Quartz 提供了更强大的任务调度能力，比 @Scheduled 注解更灵活，适用于复杂的定时任务需求。
你是否在项目中使用 Quartz？欢迎在评论区分享你的经验！ 🚀
