Cron 表达式怎么写:五个位置、三个最容易写错的地方
定时任务不生效,先别怀疑系统。这篇按「分 时 日 月 周」五个位置逐位讲清楚,并指出日和周同时填、星号与问号、时区这三个最常踩的坑。
Cron 用来描述「什么时候执行一次」,从操作系统到各种调度平台都在用。它不难,但写错的后果很直接:任务要么不跑,要么跑得比你想的勤。
01五个位置,从分钟到星期
标准写法是五个字段,用空格隔开:
| 位置 | 含义 | 取值范围 |
|---|---|---|
| 1 | 分钟 | 0—59 |
| 2 | 小时 | 0—23 |
| 3 | 日(几号) | 1—31 |
| 4 | 月 | 1—12 |
| 5 | 星期 | 0—7(0 和 7 都是周日) |
常用的几个:
0 * * * *—— 每小时整点*/5 * * * *—— 每 5 分钟0 9 * * 1—— 每周一上午 9 点30 2 1 * *—— 每月 1 号凌晨 2:300 0 * * *—— 每天零点
02坑一:日和周同时指定
第三位(日)和第五位(周)同时填具体值,是 cron 里最经典的陷阱。很多实现(含标准 crontab)的语义是「满足任意一个就执行」,不是「两个都满足」。
比如 0 0 1 * 1,本意可能是「每月 1 号且是周一的零点」,实际含义是「每月 1 号,或者每个周一」—— 触发次数比预期多得多。
要同时满足,只能选一个位置填,另一个用 *,再在任务里自己判断。 有些平台支持 ? 表示「不指定」,那才安全。
03坑二:星号和问号不是一回事
* 表示「每一位都取」,? 表示「不关心、不指定」。在 Quartz 一类的调度器里,日和周必须有一个是 ?,这样才不冲突。
但标准 Linux crontab 不认识 ?,写了会直接报错。换个平台就要重新看一眼它的语法。
04坑三:时区
Cron 本身不写时区,用的是执行环境的时区。容器里默认常常是 UTC —— 于是「每天 9 点」的备份任务实际在下午 5 点跑。
排查方法很简单:任务里先打印一次当前时间,看跟预期差几个小时。差 8 小时就是时区问题,不是表达式写错。
05怎么确认表达式写对了
光看五个星号很难心算出下一次执行时间。可靠的做法是用工具看未来几次的触发时刻:
- 连续看 5 次触发时间,能一眼发现「怎么每次都是同一分钟」或「怎么一个月才一次」;
- 再检查有没有「永不触发」的写法,比如
0 0 30 2 *(2 月没有 30 号); - 把「执行时间」和「任务本身耗多久」分开想 —— cron 只管什么时候开始,不管上一次跑完没有。
06任务重叠的时候会怎样
如果任务每 5 分钟一次,但每次要跑 8 分钟,就会出现上一轮还没结束、下一轮已经开始。标准 cron 不会阻止这种重叠,结果可能是数据重复处理、日志交错。
常见处理方式是加锁(同一时刻只允许一个实例)、或把间隔调长、或换成带「不并发」选项的调度平台。
07需要的时候直接用
输入表达式就能看到未来几次的触发时间,也会提示永远不会触发的写法。
打开Cron 表达式工具,不用注册,内容不上传。