一文精通-crontab-从入门到出坑

jiezi

5 年前

此篇技术博文主要介绍的是 crontab，Linux 下的计划任务管理工具。涉及内容包括 crontab 使用配置、常见坑的分析和编者总结的错误调试方法。

我的理解，后台任务通常分为两种：常驻和定时。之前的文章《pm2 进程管理工具使用总结》主要针对的是常驻任务。今天来谈谈 crontab，主要针对的是定时任务。

实验环境：centos7

crontab 的服务进程名为 crond，英文意为周期任务。顾名思义，crontab 在 Linux 主要用于周期定时任务管理。通常安装操作系统后，默认已启动 crond 服务。crontab 可理解为 cron_table，表示 cron 的任务列表。类似 crontab 的工具还有 at 和 anacrontab，但具体使用场景不同，可参见附录《让你学会 Linux 计划任务》一文了解更多。

关于 crontab 的用途很多，如

定时系统检测；
定时数据采集；
定时日志备份；
定时更新数据缓存；
定时生成报表；
…
等等任务

当然，更多使用场景是要以视具体情况而定了。毕竟是工具通常都是常用规则总结而成的产物。

确认 crond 服务已经安装与开启之后，下面开始具体说明

先来个简单示例体验一下。

目标：每分钟向 /tmp/time.txt 文件下写入当前时间
新建 crontab 任务

$ crontab -e      // 打开 crontab 任务编辑
* * * * * date >> /tmp/time.txt

静静等待几分钟

$ cat /tmp/time.txt
Do 29. Dez 22:45:01 CST 2016
Do 29. Dez 22:46:01 CST 2016
Do 29. Dez 22:47:01 CST 2016

从上面结果看出，每分钟执行了 date 并写入到 /tmp/time.txt。

简单示例演示成功。下面从细节深入说明 crontab 使用。

上面的实验中使用了 crontab 命令的 - e 选项。我们来看看 crontab 命令中有哪些选项?

-e 选项 表示打开当前用户的 crontab 任务列表配置文件。当然也可以直接打开，路径通常是在 /var/spool/cron/ 下，文件以用户名命名，如 /var/spool/cron/root。不过，采用 - e 方式打开，福利是可以帮助我们自动检查任务配置符合规则。

-u 选项 指定某用户的任务列表，很好理解。比如我当前是 root 用户，想操作 poloxue 用户的任务列表。如下：

$ crontab -u poloxue -e

-l 选项 列出某用户的所有任务列表
-r 选项 删除某用户的所有任务列表，这个选项使用小心为上，估计也只是自己实验时玩玩而已，正常不使用。

crontab 命令的选项中，主要使用的就是以上几个，理解比较简单。

说完了 crontab 的命令选项，下面开始真正的大戏，任务列表文件如何配置？

首先，看下 crontab 任务列表配置格式，示例文件如下：

SHELL=/bin/bash
PATH=/sbin:/bin:/usr/sbin:/usr/bin
MAILTO=root

# 更多细节 man 4 crontabs

# 计划任务定义的例子:
# .---------------- 分 (0 - 59)
# |  .------------- 时 (0 - 23)
# |  |  .---------- 日 (1 - 31)
# |  |  |  .------- 月 (1 - 12)
# |  |  |  |  .---- 星期 (0 - 7) (星期日可为 0 或 7)
# |  |  |  |  |
# *  *  *  *  * 执行的命令
* * * * * date >> /time.txt 2>&1

从上面的示例文件可看出，crontab 的任务列表主要由两部分组成：环境变量配置与定时任务配置。可能大家在工作中更多是只用到了任务配置部分。

理解环境变量配置这部分可以帮助我们减少去踩一些不必要的坑。简单说明上面涉及的环境变量。

SHELL为 /bin/bash，表示使用 /bin/bash 解释执行命令

PATH表示到哪些目录路径寻找命令程序，此环境变量的值说明了为什么我们在 crontab 中执行命令时，尽量要写命令全路径才能执行的原因。

MAILTO变量作用是当任务执行有输出时，内容发送到哪个用户的邮箱。禁用可以设置 MAILTO=””。

当我们在使用 crontab 时，发现某些定时任务不能顺利执行，但 shell 控制台执行成功，环境变量是否正确是我们需要首先关注的点之一。具体详情可以看后面关于环境变量坑的说明。

这部分是 crontab 配置核心。

如下所示配置共 6 列，前 5 列是关于执行时间配置，最后 1 列是具体执行命令。

.---------------- 分 (0 - 59)
|  .------------- 时 (0 - 23)
|  |  .---------- 日 (1 - 31)
|  |  |  .------- 月 (1 - 12)
|  |  |  |  .---- 星期 (0 - 6) (星期日可为 0 或 7)
|  |  |  |  |
*  *  *  *  * 执行的命令

第一列单位为分，表示每时第几分钟，范围为 0 -59；
第二列单位为时，表示每天第几小时，范围为 0 -23；
第三列单位为日，表示每月第几天，范围为 1 -31；
第四列单位为月，表示每年第几月，范围为 1 -12；
第五列单位为星期，表示每星期第几天，范围 0 -7，0 与 7 表示星期日，其他分别为星期 1 -6；

根据时间列中值的不同设置方式，编者总结出以下五种类型：

固定某值，指定固定值，如指定 1 月 1 日 0 时 0 分执行任务

0 0 1 1 * command

月日时分都指定了固定数值。
 注：* 在 crontab 中表示任意值都满足条件。

列表值，时间值是一个列表，如指定一个月内 2、12、22 日零时执行任务

0 0 2,12,22 * * command

上述日指定多个值，2 号、12 号和 22 号，以逗号分隔；

连续范围值，时间为连续范围的值，如指定每个月 1 至 7 号零时执行任务

0 0 1-7 * * command

上述日期为连续范围的值 1 - 7 时

步长值，根据指定数值跳跃步长确定执行时间，如指定凌晨 1 时开始每割 3 个小时 0 分执行一次任务

0 1-24/3 * * * command

上述指定从凌晨 1 时每 3 个小时执行任务，如 1 点 0 分，4 点 0 分，7 点 0 分等。

混合值，支持以上类型的组合，如指定每小时 0 至 10 分，22、33 分以及 0 -60 分钟每隔 20 分钟执行任务，如下

0-10,22,33,*/20 * * * * command

这里的分钟值采取了多种类型组合指定，包括连续范围值(0-7)，列表值(22,33)，步长值(*/20)。

声明：这几种时间配置类型是编者自己总结，希望能帮助大家更好理解。有错误帮忙指出。

通常在使用 crontab 添加任务时，我们会依靠自己已有知识编写定时语句。当需要测试语句是否正确时，总需要一定时间等待证明其正确性。作为一名牛逼的程序员，这种方式就太不酷了。有没有一款工具，只要我们给出语句，其就能告诉具体执行时间呢？下面介绍一款老外开发的 crontab 在线解析工具。

工具地址：https://crontab.guru

下面是这个工具的截图

从上面看出，我们输入的语句解析结果为每天的 04：05 执行任务。下面有这样一行文字“next at 2016-12-31 04:05:00”，告诉了我们最近一次的执行时间。

注明：百度搜索“crontab 在线解析”获得的工具有坑，某些语句解析结果错误。为避免大家受骗，这里提供具体地址：http://tool.lu/crontab/

crontab 使用中常会遇到各种坑。下面列出编者在使用中曾遇到的一些问题。

此处介绍两种坑，一种是由于基本功不足导致配置错误，而另一种则是多数人对 crontab 配置都存在的一个理解误区。

其实这个错误不用单独说明，但是编者刚开始接触 crontab 时犯过，单独拿出来说明一下。

如设定每天 3 点执行一次某任务

下面列出错误方式，当我们听到每天 3 点执行一次某任务时，很多人会把重点放在 3 点，而忽略了执行一次的需求。

下面是个错误的例子

* 3 * * * command

这里会导致在三点的每分钟都会执行一次任务，也就是执行了 60 次。
正确方式如下，每天 3 点 0 时执行任务

0 3 * * * command

这真的是个大误区，很多人都不知道的大误区。直接开始说明吧。

好，首先做两个练习

设置任务一：每月的 1 - 7 每天零时执行某任务，答案如下：

0 0 1-7 * * date >> /tmp/date.txt

设置任务二：每星期的星期一零时执行某任务，答案如下：

0 0 * * 1 date >> /tmp/date.txt

上面两个任务的设定都是正确的。

下面提出第三个任务，设置每个月的第一个星期一零时执行某任务

分解任务要求，首先，第一个星期就是每个月的 1 - 7 日，而星期一就是星期一。所以我们理解的 crontab 任务配置如下

0 0 1-7 * 1 date >> /tmp/date.txt

下面直接使用前面介绍的在线解析工具分析此语句，如下

解析结果显示语句执行时间为每月的 1 至 7 日和每星期一。可以看到最近执行时间是“next at 2017-01-01 00:00:00”，这个时间也并非星期一。

这是 crontab 的一个特别容易误解之处，下面直接给出结论:

当日和星期任一列包含 * 时，日与星期两者为并且的关系；
当日和星期列中不包含 * 时，日与星期两者为或者的关系；

请注意，前面提到的那个百度搜索出来的工具分析结果显示的确是每月第一个星期一，这是错误的。如有朋友持怀疑态度，可自行验证，如有错误，随时告知。

当我们刚使用 crontab 时，有人会告知所有命令尽量都使用绝对路径，以防错误。为什么？这就和我们下面要谈的环境变量有关了。

首先，获取控制台环境变量看下

$ env
XDG_SESSION_ID=10
HOSTNAME=localhost.localdomain
SHELL=/bin/bash
PERL_MB_OPT=--install_base /root/perl5
USER=root
MAIL=/var/spool/mail/root
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/usr/local/php5/bin
PWD=/var/mail
SHLVL=1
HOME=/root
LOGNAME=root
XDG_RUNTIME_DIR=/run/user/0
_=/usr/bin/env

考虑篇幅，输出有删减。

然后，获取 crontab 环境变量信息

* * * * * /usr/bin/env > /tmp/env.txt

输出结果，如下

$ cat /tmp/env.txt
XDG_SESSION_ID=732
SHELL=/bin/sh
USER=root
PATH=/usr/bin:/bin
PWD=/root
LANG=de_DE.UTF-8
SHLVL=1
HOME=/root
LOGNAME=root
XDG_RUNTIME_DIR=/run/user/0
_=/usr/bin/en

对比分析两者输出

对比 crontab 与控制台输出，我们发现两者的环境变量差异很大。如果命令在控制台执行成功，而在 crontab 执行失败，我们需要考虑是否命令涉及的环境变量在 crontab 和控制台间存在差异。

明白 crontab 使用绝对路径执行命令原因了吗？

我们知道命令默认查找路径是由 PATH 指定的。

从上面输出结果可知，控制台的 PATH 值为

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/usr/local/php/bin

crontab 的 PATH 值为

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/usr/local/php/bin

crontab 的 PATH 值为

PATH=/usr/bin:/bin

/usr/local/php/bin/ 下面存在 php 命令，在控制台执行成功

$ php index.php

因在 crontab 的 PATH 变量无 /usr/local/php/bin/，其执行 php 命令则会失败。

已知哪个环境变量导致问题，可以直接在 crontab 配置中加入变量配置。

不知哪个环境变量导致问题，终极大招是引入控制台环境变量，如下

* * * * * source /$HOME/.bash_profile && command

当然，对于某特定环境变量或有特定的处理方式，如 PATH，命令使用绝对路径亦可解决。

% 在 crontab 是特殊符号，具体含义如下：

第一个 % 表示标准输入的开始

* * * * * cat >> /tmp/cat.txt 2>&1 % stdin input

执行成功之后，查看 /tmp/cat.txt

$ cat /tmp/cat.txt
stdin input

我们看到标准输入写入到了 /tmp/cat.txt 文件。

理解上面示例，首先需知 cat >> /tmp/cat.txt，作用是将标准输入重定向至 /tmp/cat.txt。

其余 % 表示换行符

示例如下

* * * * * cat >> /tmp/cat_line.txt 2>&1 % stdin input 1 % stdin input 2 % stdin input 3

查看输出

$ cat /tmp/cat_line.txt
stdin input 1
stdin input 2
stdin input 3

有三行输出

解决方式

既然是特殊字符，自然而然就想到了使用进行转义，如下：

* * * * * cat >> /tmp/cat_special.txt 2>&1 % per cent is \%. 2>&1

查看输出

$ cat /tmp/cat_special.txt
per cent is %.

执行成功了。自此，你就顺利爬出了 % 特殊字符问题的坑。

关于这个问题的具体说明，可以参看附录中的《Crontab and %》。

当我们不做输出重定向时，如任务有大量输出，或许有些无法解释的问题。

输出写入邮件

crontab 任务输出默认写入到执行用户的邮件中，如下演示：

* * * * * date

命令输出当前日期，下面查看当前用户的邮件

$ cat /var/spool/mail/$USER
...

Sat Dec 31 17:45:01 CST 2016

由此可见，任务输出的日期信息写入到了用户邮件中。

如任务有大量输出，会占用磁盘资源。但编者测试显示，如磁盘容量不足，任务也会执行，但输出不会写入邮件；

关闭邮件功能

如何关闭？设置 MAILTO 环境变量为空。如下

MAILTO=""
* * * * * date

是不是关闭邮件写入就好了？附录《Linux 中的 crontab 与 sendmail》博文表明，关闭 mail 功能，输出内容将写入到 /var/spool/clientmqueue 中，可能占满分区的 inode 资源，导致任务无法执行。inode 资源使用情况可通过如下命令获取

$ df -i
Filesystem Inodes   IUsed  IFree    IUse% Mounted on
/dev/sda1  512000   378    511622   1%    /boot
/dev/sda2  92672000 185351 92486649 1%    /

抱歉！这种情况编者并未测出！但在公司的生产环境发现过未重定向则任务不执行的情况，加上后解决了问题。百度也搜索到了类似问题，如有朋友了解，欢迎指教，万分感谢。

当然，为了避免此类问题发生，建议任务都加上输出重定向，如下

* * * * * date >> /dev/null/ 2>&1

输出到 /dev/null 中，标准输入和标准错误都应处理。

如大家对重定向有疑惑，可参见附录中的《Linux 重定向》，对文解释不错。

程序员的感悟：在技术的世界，当我们不按常理做事，事情也不会按常理犯错。

最后的福利，编者根据自己的总结而梳理出一套快速定位 crontab 错误的思路。两个角度：

任务是否执行
命令是否正确

调试思路

首先，通过日志确认任务是否执行
然后，如未执行则分析定时语句，
最后，定时没有问题，检查 crond 服务是否开启

下面说明具体分析步骤。

日志确认

调试错误，日志通常是个利器，crontab 也有日志。
编者的服务器中 crontab 日志文件位置为 /var/log/cron

查看日志
日志中包含任务执行记录，配置错误提示，任务配置编辑重载记录，服务开启等记录。

下面是日志的部分内容，

$ vim /var/log/cron
...
Dec 31 19:17:01 localhost crond[1455]: (CRON) bad day-of-week (/var/spool/cron/root)
Dec 31 19:17:01 localhost CROND[4409]: (root) CMD (date)
...

这里截取了对调试比较重要的两条记录，如下介绍

执行记录

Dec 31 19:17:01 localhost CROND[4409]: (root) CMD (date)

显示 12 月 21 19 时 17 分 1 秒执行了 date 命令

配置错误

Dec 31 19:17:01 localhost crond[1455]: (CRON) bad day-of-week (/var/spool/cron/root)

上面显示 /var/spool/cron/root 的任务配置有错，也就是 root 任务配置有错。错误原因：bad day-of-week，星期配置有错。

语句是这样的

* * * * date >> /dev/null 2>&1

明显缺少了星期时间段。

确认定时语句

通过上面的日志分析，如任务没有执行，使用定时语句在线分析工具分析定时是否正确，非常简单。

确认服务开启
如果定时语句也正确，检查服务是否开启。检测命令如下

Systemd 方式(centos7 及以上)

$ systemctl status crond.service

SysVinit 方式(centos7 以下)

$ service crond status

查看命令输出，如未开启，执行如下命令开启

Systemd 方式(centos7 及以上)

$ systemctl start crond.service

SysVinit 方式(centos7 以下)

$ service crond start

确认任务成功后，如问题仍未解决，继续往下看。

确认命令成功与否，这里总结步骤大致如下

获取命令执行输出

crontab 中的命令执行出错，多数人都不知道如何调试。我们知道在控制台执行命令时，可通过输出获取错误信息调试问题。这种方式在 crontab 同样适用，方法就是利用重新向获取输出，进行分析。示例如下

* * * * * php /root/index.php >> /tmp/debug.log 2>&1

这条任务总是执行失败，我们把输出重定向到 /tmp/debug.log。

查看 debug.log，如下

$ cat /tmp/debug.log
/bin/sh: php: command not found
/bin/sh: php: command not found

显示 php 命令没有找到，很明显的就可以确定是环境变量的问题。这种方式定位问题非常有效。

具体问题具体分析

有了命令执行的输出，下面就是具体问题具体分析了。或许是前面提到的各种坑，也或许是命令本身所独有的问题。

调试的方法到这里就说完了。但还是实践为王，需持续总结，同时也希望大家不要在同样的坑中重复犯错。

crontab 写了这么长，希望能切实帮到大家。有哪位朋友看到了最后吗？表示佩服！

让你学会 Linux 计划任务
Linux 中的 crontab 与 sendmail
Crontab and %
Linux 重定向

一文精通-crontab-从入门到出坑

介绍 crontab

简单示例

使用选项

任务配置

环境变量配置部分

定时任务配置部分

基本配置

时间配置段类型

定时语句解析工具

使用有坑

时间配置误区

整点时间设置错误

日与星期的关系误区

环境变量问题

解决方式

特殊符号 %

关于输出重定向

调试大招

任务是否执行？

命令是否正确

参考附录