SpringBoot?@Scheduled?Cron表達式使用方式

更新時間：2025年03月24日 10:55:56 作者：王小工

這篇文章主要介紹了SpringBoot?@Scheduled?Cron表達式使用方式,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

Cron 表達式詳解

Cron 表達式是用于定義定時任務執(zhí)行時間的字符串，廣泛應用于 Spring 的 @Scheduled、Quartz 等定時任務框架。

其核心是通過 ‌時間字段‌ 和 ‌通配符‌ 組合實現(xiàn)復雜的調度規(guī)則。

1. 表達式格式‌

Cron 表達式由 ‌6或7個字段‌ 組成，分別表示不同時間單位（Spring 中通常用 ‌6位‌ 格式）。

格式如下：

字段	允許值	特殊字符	說明
秒（Seconds）	0-59	, - * /	可精確到秒級調度
分（Minutes）	0-59	, - * /
小時（Hours）	0-23	, - * /
日（Day）	1-31	, - * / ? L W	月份中的某一天
月（Month）	1-12 或 JAN-DEC	, - * /
周（Week）	0-7 或 SUN-SAT (0=周日)	, - * / ? L #	周幾（1=MON, 7=SUN）
年（Year）	1970-2099 (可選)	, - * /	‌Spring 中通常省略

2. 特殊字符解析

符號	作用	示例
*	匹配任意值	0 * * * * ? 每分鐘的0秒執(zhí)行
?	僅在 ‌日‌ 或 ‌周‌ 字段使用，表示“無意義”	0 0 0 * * ? 每天0點執(zhí)行
-	范圍區(qū)間	0 0 10-12 * * ? 10-12點每小時執(zhí)行
,	多個值	0 0 2,14 * * ? 每天2點和14點執(zhí)行
/	步長（間隔時間）	0 0/5 * * * ? 每隔5分鐘執(zhí)行
L	最后一天（僅 ‌日‌ 或 ‌周‌ 字段）	0 0 L * * ? 每月最后一天0點執(zhí)行
W	最近工作日（僅 ‌日‌ 字段）	0 0 0 15W * ? 每月15日最近的工作日執(zhí)行
#	指定月份的周幾（僅 ‌周‌ 字段）	0 0 0 ? * 6#3 每月第3個周五執(zhí)行

3. 常用示例

表達式	說明
0 0 12 * * ?	每天中午12點執(zhí)行
0 0/5 14 * * ?	每天下午2點開始，每隔5分鐘執(zhí)行一次
0 15 10 ? * MON-FRI	每周一至周五上午10:15執(zhí)行
0 0 0 1 1 ? 2024	2024年1月1日0點執(zhí)行（需7位表達式）
0 0 8-18/2 ? * MON	每周一上午8點到下午6點，每隔2小時執(zhí)行一次
0 0 0 L * ?	每月最后一天的0點執(zhí)行
0 0 0 15W * ?	每月15日最近的工作日執(zhí)行
0 0 0 ? * 6#3	每月第3個周五0點執(zhí)行

‌4. 重點規(guī)則

‌1. 日與周的互斥性‌

若同時指定 ‌日‌ 和 ‌周‌，需用 ? 忽略其中一個字段。
? 正確：0 0 0 ? * MON（每周一執(zhí)行，忽略日）
? 錯誤：0 0 0 * * MON（日和周同時生效，可能沖突）

2‌. 月份和星期的縮寫‌

月份：JAN, FEB, MAR… DEC
星期：SUN, MON, TUE… SAT
‌

L 和 W 的組合‌

LW 表示當月的最后一個工作日。
L-3 表示倒數第3天。‌

年份字段（可選）‌

Spring 的 @Scheduled ‌不支持年份字段‌，需用6位表達式。

5. 動態(tài)與復雜場景‌

1‌. 動態(tài) Cron 表達式‌

Spring 中可通過 @Scheduled(cron = “${cron.expression}”) 從配置文件讀取。
結合數據庫動態(tài)更新任務：

@Scheduled(cron = "#{@cronService.getCronExpression()}")
public void dynamicTask() {
    // 業(yè)務邏輯
}

2‌. 避開整點任務高峰‌

添加隨機延遲（避免多個任務同時觸發(fā)）：

@Scheduled(cron = "0 #{T(java.util.concurrent.ThreadLocalRandom).current().nextInt(55)} * * * ?")
public void randomMinuteTask() {
    // 每小時隨機分鐘執(zhí)行
}

3‌. 閏年處理‌

Cron 無法直接處理閏年，需結合代碼邏輯判斷。

6. 調試與驗證‌

1‌. 在線工具‌

Crontab Guru：快速驗證表達式。
CronMaker：生成表達式并查看下次執(zhí)行時間。

日志調試‌

在任務方法中添加日志，觀察觸發(fā)時間是否符合預期：

@Scheduled(cron = "0 0/5 * * * ?")
public void logTask() {
    log.info("任務執(zhí)行時間: {}", LocalDateTime.now());
}

7. 常見問題‌

‌1. 為什么任務沒有執(zhí)行？‌

檢查是否添加 @EnableScheduling。
檢查 Cron 表達式是否正確（如 Spring 不支持年份字段）。
檢查時區(qū)設置（默認使用服務器時區(qū)，可通過 zone 屬性修改）。

‌2. 如何實現(xiàn)每隔 N 天執(zhí)行？‌

方案1：使用 0 0 0 */N * ?（如 0 0 0 */5 * ? 每隔5天執(zhí)行）。
方案2：通過代碼記錄上一次執(zhí)行時間。

‌3. 分布式環(huán)境下的冪等性‌

使用 Redis 分布式鎖：

@Scheduled(cron = "0 0 * * * ?")
public void distributedTask() {
    if (redisLock.tryLock("taskLock", 10)) {
        try {
            // 業(yè)務邏輯
        } finally {
            redisLock.unlock("taskLock");
        }
    }
}