怎样调试Cron定时任务

调试 Cron 定时任务是运维和开发中常见的问题。Cron 任务“看起来没执行”通常有多个原因。下面从常见失败原因 → 调试方法 → 实用技巧系统地讲一下。

一、先确认 Cron 本身是否在运行

# Linux
ps aux | grep cron
# 或
systemctl status cron
# (CentOS/RHEL 可能是 crond)
systemctl status crond

如果没运行：

sudo systemctl start cron
sudo systemctl enable cron

二、检查 Cron 表达式是否正确

常见错误：

• 分钟写成了小时
• 用了 0 0 * * * 但服务器时区不对
• 用户 Cron 和系统 Cron 混淆

验证工具：

• https://crontab.guru
• 命令行：

# 查看当前用户 cron
crontab -l

# 查看系统级
cat /etc/crontab
ls /etc/cron.d/

三、最关键的：Cron 的环境变量很少

这是 90% 调试失败的原因。

Cron 默认环境：

• PATH 非常小（通常是 /usr/bin:/bin）
• 没有登录 shell
• 没有你的 ~/.bashrc

错误示例

* * * * * python script.py

正确做法

* * * * * /usr/bin/python3 /home/user/script.py >> /home/user/cron.log 2>&1

✅ 建议：

• 使用绝对路径
• 在脚本里写明 PATH
• 或直接在 cron 里设置：

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

四、把输出重定向到日志（最重要）

* * * * * /path/to/cmd >> /tmp/cron.log 2>&1

然后：

tail -f /tmp/cron.log

如果没有输出，说明：

• 命令没执行
• 或 cron 本身没触发

五、手动模拟 Cron 环境（很关键）

Cron 不是你的终端，要“像 Cron 一样跑”：

env -i /bin/bash -c '/path/to/script.sh'

或者：

/bin/sh -c '/home/user/script.sh'

六、检查权限问题

• 脚本是否有可执行权限：

chmod +x script.sh

• cron 用户是否有访问文件的权限
• 是否用了 sudo 才需要的资源

七、查看系统 Cron 日志（按系统不同）

Ubuntu / Debian

grep CRON /var/log/syslog

CentOS / RHEL

grep CRON /var/log/cron

能看到：

• 是否触发
• 以哪个用户运行

八、常见坑总结

九、一个“安全模板”示例

SHELL=/bin/bash
PATH=/usr/local/bin:/usr/bin:/bin

*/5 * * * * /usr/bin/python3 /home/user/job.py >> /home/user/job.log 2>&1

如果你愿意，可以：

• 贴出你的 crontab 内容
• 或说明 系统（Ubuntu/CentOS？）
• 或描述 “手动能跑，cron 不行”

我可以直接帮你定位问题。