cron4j 定時任務表達式：每天凌晨 4 點執行，正確寫法是「0 4 * * * ?」而非 Quartz 風格

使用 cron4j 插件配置定時任務，照搬 Quartz/Spring 的 0 0 4 * * ? 卻報 InvalidPatternException。根因：cron4j 表達式只有 5/6 段（無秒欄位），順序為 分 時 日 月 周 [年]。本文詳解差異並給出正確配置。

錯誤配置與異常

UpdateOrderStatusJob.cron=0 0 4 * * ?  # 錯誤：含秒欄位，cron4j 不支援

Exception: it.sauronsoftware.cron4j.InvalidPatternException: invalid pattern: "0 0 4 * * ?"

cron4j vs Quartz 表達式對比

正確配置：每天凌晨 4 點

# cron4j 格式：分 時 日 月 周
UpdateOrderStatusJob.cron=0 4 * * *

• 0：第 0 分
• 4：第 4 時（凌晨 4 點）
• * * *：每天、每月、每周

驗證方式

// 測試代碼
import it.sauronsoftware.cron4j.SchedulingPattern;

public class TestCron4j {
    public static void main(String[] args) {
        SchedulingPattern pattern = new SchedulingPattern("0 4 * * *");
        System.out.println("Next: " + pattern.next(System.currentTimeMillis()));
        // 輸出下一次執行時間戳，驗證是否為明天 04:00
    }
}

常用 cron4j 表達式速查

避坑指南

1. 不要照搬 Quartz 表達式：cron4j 無秒欄位，欄位順序左移一位。
2. 問號 ? 不支援：cron4j 無「日/周衝突」概念，直接用 *。
3. 年欄位可選：6 段格式 分 時 日 月 周 年，通常 5 段足夠。
4. 時區：cron4j 使用 JVM 默認時區，跨時區部署需显式設定 TimeZone.setDefault()。

下次配置 cron4j，默念口訣：「分時日月周，無秒無問號」，一把過。