Quartz 定時任務框架核心概念與 Spring 整合實戰

Quartz 定時任務：從核心架構到 Spring 整合完整指南

Quartz 是 Java 生態系中最成熟、功能最豐富的開源任務調度框架。本文系統梳理其核心概念、架構設計，並提供 Spring 整合的實戰配置範例，幫助開發者快速掌握企業級定時任務的構建方法。

為什麼需要 Quartz？

在企業級應用中，定時任務無處不在：

• 用戶體驗優化：註冊歡迎通知、生日祝福、活動提醒等精準觸達
• 數據倉庫構建：日報表生成、ETL 抽取轉換載入、存儲過程批次執行
• 業務流程自動化：物流逾期預警、金融日終結算、合約到期續約處理
• 系統維護：日誌清理、快照備份、緩存預熱、健康檢查

相較於簡單的 Timer 或 ScheduledExecutorService，Quartz 提供了持久化、叢集、事務支援、Cron 表達式等企業級特性。

Quartz 核心三大組件

Quartz 將調度領域高度抽象為三個核心介面：

關係圖譜：

• 一個 Job 可綁定多個 Trigger (一對多)
• 一個 Trigger 僅能關聯一個 Job (一對一)
• Scheduler 管理多個 Trigger (一對多)

觸發器類型詳解

SimpleTrigger - 固定頻率執行

• 適用場景：每隔 N 秒/分/時執行一次
• 核心參數：repeatInterval (間隔毫秒數)、repeatCount (重複次數，-1 表示無限)
• Spring 對應：org.springframework.scheduling.quartz.SimpleTriggerFactoryBean

CronTrigger - 複雜時間表達式

• 適用場景：每天固定時間、每月特定日期、工作日排程等
• Cron 表達式結構：秒 分 時 日 月 週 [年] (7 個欄位)
• 常用範例：
  • 0 0 2 * * ? - 每天凌晨 2 點
  • 0 30 9 ? * MON-FRI - 工作日早上 9:30
  • 0 0 0 1 * ? - 每月 1 號午夜
• Spring 對應：org.springframework.scheduling.quartz.CronTriggerFactoryBean

Spring 整合 Quartz 完整配置範例

採用 Spring 的 MethodInvokingJobDetailFactoryBean 將任務委派給 Spring Bean 方法，實現鬆耦合：

服務層實作範例

@Service("payCalculateService")
public class PayCalculateService {
    @Resource(name = "daoSupport")
    private DaoSupport dao;

    /**
     * 結息(罰息)定時計算 - 每日執行
     */
    public String settlementCalculate() throws Exception {
        String settlementDate = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
        PageData pd = new PageData();
        pd.put("settlement_date", settlementDate);
        
        // 呼叫 MyBatis Mapper 中定義的存儲過程
        dao.findForObject("PayCalculateMapper.settlementCalculate", pd);
        return "SUCCESS";
    }
}

MyBatis 呼叫存儲過程配置

生產環境最佳實踐建議

1. 叢集模式部署：配置 org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX 使用資料庫持久化，設定 org.quartz.jobStore.isClustered = true 實現高可用
2. 任務冪等性設計：業務邏輯需支援重複執行不產生副作用，配合資料庫唯一約束或分散式鎖
3. 監控與告警：整合 Micrometer/Prometheus 監控任務執行耗時、成功率、堆積情況
4. 優雅關閉：實作 SmartLifecycle 或註冊 JVM 關閉鉤子，確保 scheduler.shutdown(true) 等待執行中任務完成
5. 分散式鎖防重：叢集環境下，關鍵任務加上 Redis/ZooKeeper 分散式鎖，避免多節點同時執行

常見問題排查