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