上线一个定时任务,本地测得好好的,服务器上就是不跑。排查了半天,发现 cron 写的是 0 8 * * *,但服务器时区是 UTC——它确实在八点跑了,只不过是 UTC 的八点,国内下午四点。
这类问题几乎每个做后端的人都遇到过。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,然后跳过周末。一眼就能看出对不对。
二是直接看日志。第一次上线,把执行日志打出来,守一个周期。花二十分钟,省掉后面几天的排查。
推荐工具
粘贴表达式就能看中文解释和后续执行时间,调试时随手用:
相关的
要算时间戳的,用时间戳转换;写正则匹配日志内容,看正则表达式语法速查;检查服务器权限导致脚本跑不起来的,用Linux权限计算器算一下 chmod 值。
一句经验:定时任务出错,八成不是 cron 写错,是环境不一样。先在目标环境手动跑一次脚本,能跑通,再谈定时。