Cron 表达式详解:完全指南

Cron 表达式详解:5 个字段、特殊字符、常用写法、“日”和“星期”的陷阱、时区,以及 Spring 和 Quartz 的区别。

阅读约 3 分钟

Cron 表达式是一行很短的文本,用来告诉调度器什么时候执行任务。Linux 的 crontab、Kubernetes 的 CronJob、GitHub Actions 以及很多任务库都在用它。这篇 cron表达式详解 先讲标准的 5 字段写法,再讲最容易出错的几个地方,帮助你看懂 cron表达式语法,并掌握常见的 crontab用法。

5 个字段

┌───────────── 分钟(0–59)
│ ┌─────────── 小时(0–23)
│ │ ┌───────── 日(1–31)
│ │ │ ┌─────── 月(1–12 或 JAN–DEC)
│ │ │ │ ┌───── 星期(0–7 或 SUN–SAT,0 和 7 都是星期日)
│ │ │ │ │
* * * * *  要执行的命令

当前时间和所有字段都匹配时,任务就会执行。30 8 * * * 表示 8 点 30 分,日和月都不限,也就是每天 8:30。理解这 5 个字段是掌握 cron表达式语法 的第一步。

特殊字符

字符 含义 示例
* 所有值 * * * * * 每分钟执行
, 列举多个值 0 9,18 * * * 在 9:00 和 18:00 执行
- 范围 0 9 * * 1-5 工作日 9:00 执行
/ 间隔 */15 * * * * 每 15 分钟执行

间隔也可以和范围一起用:0 9-17/2 * * * 会在 9:00、11:00、13:00、15:00 和 17:00 执行。大多数实现还支持简写:@hourly、@daily、@weekly、@monthly、@yearly,以及 @reboot(开机时执行一次)。这些简写是 crontab用法 里很常见的省力写法。

常用写法

表达式 执行时间
*/5 * * * * 每 5 分钟
0 * * * * 每小时整点
0 */6 * * * 每 6 小时(0:00、6:00、12:00、18:00)
0 2 * * * 每天 2:00
30 8 * * 1-5 工作日 8:30
0 9-17 * * 1-5 工作日 9:00 到 17:00 之间每小时一次
0 9 * * 1 每周一 9:00
0 22 * * 0,6 周末 22:00
0 0 1 * * 每月 1 号零点
0 0 1 1 * 每年 1 月 1 日零点

把任意一条粘贴到 Cron 表达式解析 工具里,就能看到接下来的执行时间。

“日”和“星期”的陷阱

同时限定了“日”和“星期”时,标准 cron 会在满足其中一个的日子执行,而不是两个都满足才执行。0 9 1 * 1 并不是“1 号恰好是星期一时执行”,而是每月 1 号和每个星期一都会执行。这是 cron表达式详解 中最常被忽视的规则之一。

这条规则只在两个字段都不以 * 开头时生效。如果想在每月第一个星期一执行,可以把“日”限定为 1–7,再在命令里判断星期:

0 9 1-7 * * [ "$(date +\%u)" -eq 1 ] && /path/to/job

在 crontab 里,% 有特殊含义(表示标准输入的开始),所以要写成 \%。这类细节在实际 crontab用法 中很容易踩坑。

时区和夏令时

cron 按运行它的机器或服务的时区执行:

  • Linux crontab 用系统时区。cronie 等部分实现还支持在文件里写一行 CRON_TZ=。
  • Kubernetes CronJob 默认用控制器的时区,可以用 spec.timeZone 指定,例如 Asia/Shanghai。
  • GitHub Actions 的定时任务始终按 UTC 计算,负载高时可能晚几分钟才开始,而且最短只能每 5 分钟执行一次。

在有夏令时的地区,如果任务正好安排在被跳过或重复的那个小时里,可能不执行,也可能执行两次,具体取决于实现。必须每天只执行一次的任务,最好避开当地时间 1:00–3:00,或者让机器使用 UTC。

Spring 和 Quartz

Java 的调度框架用的是带秒字段的变体:

Linux cron Spring Quartz
字段数 5 6(最前面是秒) 6 或 7(最前面是秒,年可选)
星期日 0 或 7 0 或 7 1
L、W、#、? 不支持 支持 支持
同时指定“日”和“星期” 满足一个即可 两个都要满足 必须有一个写 ?

两者的详细规则见 Spring Cron 表达式生成器 和 Quartz Cron 表达式生成器。这部分是对标准 cron表达式语法 的扩展,写法并不完全兼容。

上线前先检查

写错的 cron 表达式通常不会报错,只会在错误的时间执行,或者根本不执行。上线前把它粘贴到 Cron 表达式解析 工具里:工具会用大白话解释它的含义,并按本地时间或 UTC 列出接下来 10 次执行时间。把这篇 cron表达式详解 当作速查,再配合工具验证,能减少大部分定时任务的配置失误。