Quartz Cron 表達式完全手冊：語法詳解、常用範例與避坑指南

CronTrigger 核心優勢

相較 SimpleTrigger 的固定間隔，CronTrigger 基於日曆邏輯，支持複雜時間調度：

• 「每周五中午 12:00」
• 「工作日上午 9:30」
• 「周一、三、五上午 9:00-10:00 每 5 分鐘一次」

擁有 startTime（生效時間）與可選 endTime（終止時間）邊界控制。

Cron 表達式結構：7 域語法

標準 Quartz Cron 表達式由 **7 個子表達式** 組成，以空格分隔：

[秒] [分] [時] [日] [月] [周] [年(可選)]

特殊字符深度解析

• *：所有值（每秒、每分...）
• ?：**僅用於 Day of Month / Day of Week**，表示「不指定值」，二者必須有一個用 ?（避免衝突）。
• -：範圍，如 MON-FRI 表示周一至周五。
• ,：枚舉，如 MON,WED,FRI。
• /：增量/步長，如 0/15 在分鐘域表示每小時 0、15、30、45 分；5/15 表示 5、20、35、50 分。
• L：Last，Day of Month 表示月最後一天（31/30/28/29），Day of Week 表示周六（7/SAT），6L 表示本月最後一個周五。
• W：工作日（最近的工作日），15W 表示離 15 號最近的工作日（若 15 是周六則取 14，周日取 16）。
• #：第 N 個星期幾，6#3 表示本月第三個周五（6=FRI, 3=第三個）。

高頻實用範例速查表

Java 代碼中構建 CronTrigger

import org.quartz.*;
import org.quartz.impl.StdSchedulerFactory;

public class CronJobDemo {
    public static void main(String[] args) throws SchedulerException {
        Scheduler scheduler = StdSchedulerFactory.getDefaultScheduler();
        
        JobDetail job = JobBuilder.newJob(MyJob.class)
            .withIdentity("cronJob", "group1").build();
        
        // 每天凌晨 3:15 執行
        CronTrigger trigger = TriggerBuilder.newTrigger()
            .withIdentity("cronTrigger", "group1")
            .withSchedule(CronScheduleBuilder.cronSchedule("0 15 3 * * ?"))
            .build();
        
        scheduler.scheduleJob(job, trigger);
        scheduler.start();
    }
}

class MyJob implements Job {
    @Override public void execute(JobExecutionContext context) {
        System.out.println("定時任務執行時間: " + new Date());
    }
}

避坑指南

1. 秒域必填：Quartz 為 7 域，Spring @Scheduled(cron="...") 為 6 域（無秒），**切勿混用**。
2. 日/周互斥：Day of Month 與 Day of Week 不能同時具體指定，必須有一個用 ?。
3. 時區陷阱：默認使用 JVM 時區，分布式部署時建議顯式指定 TimeZone 或統一 UTC。
4. L、W、# **不可組合** 使用（如 15LW 無效）。
5. 線上修改 Cron 表達式需**重新調度**，熱更新需框架支持（如 Spring Boot Quartz 數據庫持久化模式）。