cron表达式怎么写?每5分钟、每天8点的定时任务写法

5 阅读

上线一个定时任务,本地测得好好的,服务器上就是不跑。排查了半天,发现 cron 写的是 0 8 * * *,但服务器时区是 UTC——它确实在八点跑了,只不过是 UTC 的八点,国内下午四点。

这类问题几乎每个做后端的人都遇到过。cron 只有五个字段,坑却不少。

Cron表达式解析器界面:表达式翻译与后续执行时间预估
翻译成中文再看执行时间,比对着语法表推理快

五个字段的顺序

从左到右依次是:分、时、日、月、周。每个字段之间用空格分开。

取值范围:分 0–59,时 0–23,日 1–31,月 1–12,周 0–7(0 和 7 都表示周日)。

记不住顺序的话,按"分时日月周"念一遍,比背英文缩写靠谱。

常写的几种

  • */5 * * * *:每 5 分钟一次。
  • 0 * * * *:每小时整点一次。
  • 0 8 * * *:每天 8:00。
  • 30 2 * * *:每天凌晨 2:30,备份常用这个点。
  • 0 9 * * 1-5:周一到周五 9:00,工作日提醒。
  • 0 0 1 * *:每月 1 号零点。
  • 0 3 * * 0:每周日 3:00。

注意 */5 和 5 是两个意思。前者是"每隔 5 个单位",后者是"第 5 个单位那一次"。写在分钟位,一个是每 5 分钟,一个是每小时的第 5 分钟——一小时只跑一次。

三个真正的坑

第一个,日和周同时写。很多人以为 0 0 1 * 1 是"每月 1 号且是周一"。实际上绝大多数 cron 实现里,这两个字段是或关系——每月 1 号跑,或者每个周一跑。想表达"且",得在脚本里自己判断。

第二个,时区。cron 用的是系统时区。容器里默认常常是 UTC,跟你本地差八小时。要么把容器时区设成 Asia/Shanghai,要么在表达式上补偿。上线前一定要看一次实际执行记录,别信"应该没问题"。

第三个,月和周的起始。月份是 1–12,不是 0–11,这点跟 JavaScript 的 Date 正好相反,写惯了前端的人容易顺手写错。周的 0 是周日,1 是周一,但有些系统把周一当 0,换平台要重新确认。

写完怎么验证

两个办法,都很实用。

一是让工具把表达式翻译成中文,再列出接下来几次的执行时间。看那几行时间对不对,比对着语法表推理快得多。比如 */15 9 * * 1,2,3,4,5,翻译过来是"每 15 分钟,小时为 9,每日,月份不限,星期为 1 到 5",预计执行时间是 9:00、9:15、9:30、9:45,然后跳过周末。一眼就能看出对不对。

二是直接看日志。第一次上线,把执行日志打出来,守一个周期。花二十分钟,省掉后面几天的排查。

推荐工具

粘贴表达式就能看中文解释和后续执行时间,调试时随手用:

Cron表达式解析器解析常见 5 段 Cron 表达式,显示中文说明和未来执行时间。立即使用

相关的

要算时间戳的,用时间戳转换;写正则匹配日志内容,看正则表达式语法速查;检查服务器权限导致脚本跑不起来的,用Linux权限计算器算一下 chmod 值。

一句经验:定时任务出错,八成不是 cron 写错,是环境不一样。先在目标环境手动跑一次脚本,能跑通,再谈定时。

查看更多
JSON解析报错怎么查?Unexpected token 排查JSON解析报错怎么查?Unexpected token 排查网站打不开显示403、502?按状态码分清是谁的问题网站打不开显示403、502?按状态码分清是谁的问题正则表达式怎么写?常用符号含义与实例速查正则表达式怎么写?常用符号含义与实例速查SSL证书还有多久到期?HTTPS证书检查清单SSL证书还有多久到期?HTTPS证书检查清单