如何调试debian crontab

在 Debian 上调试 crontab 通常分为确认任务是否执行、查看日志、排查环境变量和权限问题几个步骤。下面按实用顺序说明。

一、确认 crontab 本身是否正常

1. 查看当前用户的 cron 任务

crontab -l

2. 编辑 cron 任务

crontab -e

3. 查看 cron 服务状态

systemctl status cron

如果没运行：

sudo systemctl start cron
sudo systemctl enable cron

二、查看 cron 日志（最重要）

Debian 默认使用 rsyslog，cron 日志在：

sudo tail -f /var/log/syslog | grep CRON

或：

sudo grep CRON /var/log/syslog

你可以看到类似：

CRON[1234]: (user) CMD (/path/to/script.sh)

✅ 有记录 → cron 执行了
❌ 没记录 → cron 没触发（时间/服务问题）

三、最常见问题：脚本手动能跑，cron 不能跑

1. 环境变量不同（90% 的问题）

cron 的环境非常干净：

PATH=/usr/bin:/bin

没有你 shell 里的 PATH、HOME、PYTHONPATH 等。

✅ 解决方式：

• 在 crontab 里显式写 PATH

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

• 脚本里用绝对路径

/usr/bin/python3 /home/user/script.py

2. 输出没地方去，导致“看起来没执行”

cron 会把输出 mail 给用户，但很多系统没配 mail。

✅ 建议重定向输出：

* * * * * /home/user/test.sh >> /home/user/cron.log 2>&1

然后：

tail -f /home/user/cron.log

3. 权限问题

• 脚本没执行权限

chmod +x /home/user/test.sh

• 用户没有 cron 权限

cat /etc/cron.allow
cat /etc/cron.deny

四、使用简单测试任务

先放一个测试：

* * * * * echo "cron works $(date)" >> /tmp/cron_test.log

等一分钟：

cat /tmp/cron_test.log

✅ 有内容 → cron 正常
❌ 没内容 → cron 没跑（看服务/日志）

五、调试脚本本身

在脚本开头加：

#!/bin/bash
set -x

并把输出重定向到日志，能看到每一步执行。

六、systemd 定时任务（可选替代）

如果 cron 太难调，可用：

systemctl --user edit --full mytask.timer

七、快速排查清单 ✅

• [ ] cron 服务在运行
• [ ] crontab -l 能看到任务
• [ ] /var/log/syslog 有 CRON 记录
• [ ] 脚本用绝对路径
• [ ] 输出已重定向
• [ ] 脚本有执行权限

如果你愿意，可以把 你的 crontab 内容 + 脚本 + 日志 贴出来，我可以直接帮你定位问题。