Cron 表達式參考

進階模式

組合列表和範圍

欄位接受混合語法。在工作日上午 8 點和下午 6 點執行任務：

0 8,18 * * 1-5

使用步進指定特定月份：

0 0 1 1-12/3 *    # 從一月開始每 3 個月（1月、4月、7月、10月）

日 vs. 星期

當日和星期都被設定（非 *）時，行為取決於實作。在標準 cron 中，如果任一條件滿足，任務就會執行——是 OR 關係，不是 AND。這讓很多人措手不及。

0 0 15 * 1

啟動時執行

雖然嚴格來說不是 cron 表達式，但 @reboot 是一個廣泛支援的簡寫：

@reboot /usr/local/bin/start-service.sh

其他常見簡寫：

簡寫	等效表達式
@yearly	0 0 1 1 *
@monthly	0 0 1 * *
@weekly	0 0 * * 0
@daily	0 0 * * *
@hourly	0 * * * *

不同環境中的 Cron

Linux Crontab

經典方式。使用 crontab -e 編輯使用者 crontab：

# 每天凌晨 2 點執行備份
0 2 * * * /home/user/scripts/backup.sh >> /var/log/backup.log 2>&1

/etc/cron.d/ 中的系統級 cron 任務包含額外的使用者欄位：

0 2 * * * root /usr/local/bin/cleanup.sh

GitHub Actions

GitHub Actions 在 schedule 觸發器中使用相同的五欄位語法。所有時間為 UTC。

on:
  schedule:
    - cron: '0 3 * * 1-5'   # 工作日 UTC 凌晨 3 點

有關 YAML 設定的深入了解，請參閱 Kubernetes 的 YAML 和 Docker Compose 的 YAML。

常見陷阱

2. 執行重疊

如果任務耗時超過執行間隔，你將得到重疊的實例。在 */5 * * * * 排程上執行 8 分鐘的腳本會堆積。

解決方案：

• 使用鎖定檔案（Linux 上的 flock）
• 在 Kubernetes CronJob 中設定 concurrencyPolicy: Forbid
• 在腳本開始時檢查正在執行的實例

4. 「每月 31 日」陷阱

0 0 31 * *    # 僅在有 31 天的月份執行

這在 1 月、3 月、5 月、7 月、8 月、10 月和 12 月執行，但會靜默跳過其他五個月。如果需要月末任務，考慮在 1 日執行並調整腳本邏輯，或使用支援「月末」語意的工具。

5. 忘記 Crontab 末尾的換行符

某些 cron 實作要求 crontab 檔案末尾有換行符。如果最後一個條目不執行，在末尾新增空行。

Kubernetes CronJob

apiVersion: batch/v1
kind: CronJob
metadata:
  name: nightly-report
spec:
  schedule: "0 2 * * *"
  jobTemplate:
    spec:
      template:
        spec:
          containers:
            - name: report
              image: reporting:latest
              command: ["python", "generate_report.py"]
          restartPolicy: OnFailure