定时任务没跑别瞎猜:crontab 五个最常见的坑

举报
yd_273693568 发表于 2026/11/12 00:42:18 2026/11/12
【摘要】 一、手动能跑,到点不动:定时任务的经典难题把备份命令写成脚本,手动一敲一切正常,挂到 crontab 里却雷打不动地"沉默"——到点不执行、执行了没结果、日志里什么都没有。这是新手接触定时任务时最常撞上的场景,也最容易让人怀疑人生。其实 crontab 的问题九成落在五个坑里:时间表达式写错、环境不一样、百分号没转义、输出不知去向、日志没找对地方。这篇按排查顺序把五个坑挨个拆开,每个坑都给出...

一、手动能跑,到点不动:定时任务的经典难题

把备份命令写成脚本,手动一敲一切正常,挂到 crontab 里却雷打不动地"沉默"——到点不执行、执行了没结果、日志里什么都没有。这是新手接触定时任务时最常撞上的场景,也最容易让人怀疑人生。其实 crontab 的问题九成落在五个坑里:时间表达式写错、环境不一样、百分号没转义、输出不知去向、日志没找对地方。这篇按排查顺序把五个坑挨个拆开,每个坑都给出对应的验证命令,看完就能自己定位。

二、先确认任务真的写进去了

动手排查之前,先排除最"冤枉"的一种情况:你以为写进去了,其实写错了地方。root 用户在终端敲 crontab root-backup.txt 这种命令会把文件内容覆盖掉自己当前用户的 crontab;也有人编辑了 /etc/crontab,却以为改的是自己的 crontab——两回事。验证只认一条命令:

crontab -l          # 看当前用户已生效的定时任务
sudo crontab -l     # 看 root 的定时任务
cat /etc/crontab    # 系统级任务,格式多了个用户列

crontab -e 编辑的是"当前用户"的任务表,保存后由 cron 守护进程接管;/etc/crontab 是系统级文件,它的每行要多写一个用户名列(0 3 * * * root /opt/backup.sh),直接把用户 crontab 的行拷过去会静默不执行。另外改完 /etc/crontab 不用重启服务,但改 /etc/cron.d/ 下的文件时注意文件名不能带点号和下划线之外的奇怪字符,命名不合规会被 cron 直接忽略。

三、第一坑:时间表达式写错

五段式的顺序是分 时 日 月 周,新手最常见的错误有两种:一是把顺序记反,比如写成 * 3 * * * 本意是"每天 3 点整",实际含义是"每天 3 点这一小时里的每一分钟都执行"——任务照样跑,但一小时跑 60 次。二是 */5 这类步进写法只对单独字段生效,*/5 3 * * * 是"3 点这一小时内每 5 分钟一次",不是"每 5 小时"。想表达"每 3 小时"得写 0 */3 * * *。验证方法很朴素——把表达式拆开念一遍:

# 每天 03:30 执行一次
30 3 * * * /opt/backup.sh
# 每 5 分钟一次(做测试用)
* * * * * /opt/backup.sh
# 每小时的第 0 分和第 30 分各一次
0,30 * * * * /opt/backup.sh

还有一个隐蔽项是时区。服务器时区是 UTC 时,你以为的"凌晨 3 点"其实是北京时间 11 点。先 date 看一眼当前系统时间,再 timedatectl 确认时区;不一致就在 /etc/localtime 或 timedatectl set-timezone 里改正,别靠"倒推几小时"硬换算,夏令时一来全乱。

四、第二坑:cron 的环境和你的终端不是一回事

这是 crontab 的头号大坑:cron 执行任务时不带你的登录环境。它的 PATH 只有极短的几个目录,没有你 source 过的变量,也没有别名。手动能跑、放进 cron 就挂的脚本,多数死在这里。对策只有一条:路径全用绝对路径,变量自己显式加载。

# 错误示范:依赖终端环境
* * * * * backup.sh
# 正确示范:绝对路径 + 显式声明环境
* * * * * /bin/bash /opt/scripts/backup.sh >> /var/log/backup.log 2>&1

脚本内部调用的 python、docker、mysqldump 等命令也要写成绝对路径(用 command -v 命令名 查出来),或者在脚本开头重设 PATH。环境变量为什么会这样,原理在上一篇《command not found 的真相》里已经展开过,这里只记结论:cron 的环境约等于一个裸 shell,你给它什么它有什么。

五、第三坑:百分号 % 是保留字符

cron 把命令行里第一个 % 当成"标准输入结束",后面的内容会被当成另一行命令——这条规则藏在 man 手册深处,90% 的新手不知道。所以想用 date +%F 给备份文件打时间戳时,任务会悄悄失败或者文件名不对。写法是把每个 % 转义成 \%:

# 错误:第一个 % 之后全被截断
0 3 * * * /opt/backup.sh /var/backup/$(date +%F).tar.gz
# 正确:
0 3 * * * /opt/backup.sh /var/backup/$(date +\%F).tar.gz

这类错误更隐蔽的后果是任务"部分执行":命令主体跑了,但参数变成了残缺片段。遇到"执行了但行为怪异",先检查命令里有没有裸 %。

六、第四坑:输出和报错去哪了

定时任务失败时不会有人在你面前报错——cron 会把任务的标准输出和错误寄邮件给本机用户(存到 /var/mail/用户名 或 /var/spool/mail/)。很多服务器根本没配邮件,输出就无声无息地丢掉,你连它执行过都不知道。所以每条任务都要显式重定向输出:

0 3 * * * /opt/backup.sh >> /var/log/backup.log 2>&1

2>&1 的意思是"标准错误合并进标准输出",少了它日志里只有正常输出、报错全丢。如果确实不需要任何输出,写成 > /dev/null 2>&1 丢弃——只写 > /dev/null 的话报错仍然会尝试发邮件,机器日志里会攒下大量"MAILER-DAEMON"垃圾记录。

七、第五坑:日志看对地方才有答案

排错最后一步是看 cron 自己的日志,它会记下"几点调度了哪个任务"。不同发行版位置不同:

# Debian/Ubuntu
grep CRON /var/log/syslog | tail -20
# CentOS/RHEL/Rocky
tail -50 /var/log/cron
# 通用(systemd 系统)
journalctl -u cron -n 30        # Ubuntu 服务名叫 cron
journalctl -u crond -n 30       # CentOS 服务名叫 crond

日志里看到 "(root) CMD (/opt/backup.sh)" 说明调度动作发生了——到这一步任务没生效就要回头查坑二、三、四(环境、转义、输出);如果连 CMD 行都没有,说明表达式或 crontab 本身有问题,回到坑一检查。ubuntu 上如果日志里出现 "(CRON) INFO (No MTA installed)",就是上面说的邮件无处可去,重定向输出即可消除。

八、一条模板走天下

把五个坑合起来,就是一个可以直接抄的任务模板:绝对路径命令、显式 bash、合并错误、落日志:

0 3 * * * /bin/bash /opt/scripts/backup.sh >> /var/log/backup.log 2>&1

新任务上线前,先写成 * * * * * 每分钟执行一次做验证:等 1–2 分钟看日志文件有没有内容、cron 日志有没有 CMD 行,确认通过后再改回正式时间。这个"每分钟验证法"能把排错时间从半小时缩到两分钟,比任何技巧都管用。定时任务的本质就是把"人肉敲命令"交给调度器,而调度器不会替你补环境、不会替你报错——这五座大山搬掉之后,crontab 就只剩写时间表这一件事了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。