快捷導(dǎo)航

SpringBoot集成Quartz實(shí)現(xiàn)定時(shí)任務(wù)方式(Cron表達(dá)式示例)

更新時(shí)間：2026年02月04日 09:08:38 作者：易xingxing

本文介紹了如何在SpringBoot項(xiàng)目中集成Quartz并使用Cron表達(dá)式進(jìn)行任務(wù)調(diào)度,通過(guò)添加依賴、創(chuàng)建任務(wù)、配置調(diào)度、啟動(dòng)項(xiàng)目和Cron表達(dá)式詳解,展示了Quartz的強(qiáng)大功能和靈活性

前言

在 Spring Boot 項(xiàng)目中，我們經(jīng)常需要定時(shí)執(zhí)行某些任務(wù)，例如定期清理數(shù)據(jù)庫(kù)、同步數(shù)據(jù)、發(fā)送通知等。

Quartz 是一個(gè)強(qiáng)大的任務(wù)調(diào)度框架，可以通過(guò) Cron 表達(dá)式 實(shí)現(xiàn)靈活的任務(wù)調(diào)度。本篇文章將介紹如何在 Spring Boot 中集成 Quartz 并使用 Cron 表達(dá)式 進(jìn)行任務(wù)調(diào)度。

1. 添加 Quartz 依賴

在 Spring Boot 項(xiàng)目中，首先需要引入 Quartz 相關(guān)依賴。

如果使用 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. 創(chuàng)建 Quartz 任務(wù)

在 Quartz 中，每個(gè)定時(shí)任務(wù)需要繼承 org.quartz.Job 接口，并實(shí)現(xiàn) execute 方法。

import org.quartz.Job;
import org.quartz.JobExecutionContext;
import org.quartz.JobExecutionException;
import java.time.LocalDateTime;

public class MyQuartzJob implements Job {
    @Override
    public void execute(JobExecutionContext context) throws JobExecutionException {
        System.out.println("Quartz 定時(shí)任務(wù)執(zhí)行中：" + LocalDateTime.now());
    }
}

3. 配置 Quartz 任務(wù)調(diào)度

Spring Boot 允許通過(guò) SchedulerFactoryBean 配置 Quartz 任務(wù)，并使用 @Bean 方式定義任務(wù)的調(diào)度規(guī)則。

import org.quartz.*;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class QuartzConfig {

    // 定義 JobDetail
    @Bean
    public JobDetail myJobDetail() {
        return JobBuilder.newJob(MyQuartzJob.class)
                .withIdentity("myQuartzJob")  // 任務(wù)名稱
                .storeDurably()
                .build();
    }

    // 定義觸發(fā)器，使用 Cron 表達(dá)式
    @Bean
    public Trigger myJobTrigger() {
        return TriggerBuilder.newTrigger()
                .forJob(myJobDetail())
                .withIdentity("myQuartzTrigger") // 觸發(fā)器名稱
                .withSchedule(CronScheduleBuilder.cronSchedule("0 0/5 0-7 ? * * *")) // Cron 表達(dá)式
                .build();
    }
}

在上述配置中，我們的定時(shí)任務(wù)：

每 5 分鐘執(zhí)行一次
每天從 00:00 到 07:59 之間執(zhí)行
使用 Cron 表達(dá)式 0 0/5 0-7 ? * * *

如果需要 08:00 也執(zhí)行一次，可以修改 Cron 表達(dá)式為：

0 0/5 0-8 ? * * *

4. 啟動(dòng) Spring Boot 觀察定時(shí)任務(wù)執(zhí)行

啟動(dòng) Spring Boot 項(xiàng)目，觀察控制臺(tái)輸出：

Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T00:00:00
Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T00:05:00
Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T00:10:00
...
Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T07:55:00

如果 Cron 表達(dá)式修改為 0 0/5 0-8 ? * * *，則會(huì)多執(zhí)行一次：

Quartz 定時(shí)任務(wù)執(zhí)行中：2024-03-19T08:00:00

5. Quartz Cron 表達(dá)式詳解

Quartz 的 Cron 表達(dá)式有 7 個(gè)字段，每個(gè)字段的含義如下：

字段	允許值	說(shuō)明
秒（Seconds）	0-59	任務(wù)觸發(fā)的秒數(shù)
分（Minutes）	0-59	任務(wù)觸發(fā)的分鐘數(shù)
小時(shí)（Hours）	0-23	任務(wù)觸發(fā)的小時(shí)數(shù)
日期（Day of month）	1-31	任務(wù)觸發(fā)的日期（不能與 Day of week 同時(shí)指定）
月份（Month）	1-12 或 JAN-DEC	任務(wù)觸發(fā)的月份
星期（Day of week）	1-7 或 SUN-SAT	任務(wù)觸發(fā)的星期幾
年（可選）	空或 1970-2099	任務(wù)觸發(fā)的年份