Linux crontab 定时任务不执行怎么排查？

Question

仓乃文 · Accepted Answer

crontab 定时任务是 Linux 运维的基础，但"手动执行正常，crontab 里不执行"是最常见的噩梦。90% 的原因不是脚本写错了，而是 crontab 的执行环境和终端环境完全不同。

crontab 环境与终端环境的区别：
```
| 维度       | 终端环境              | crontab 环境           |
|-----------|----------------------|----------------------|
| PATH      | 完整（含自定义路径）   | 只有 /usr/bin:/bin    |
| 环境变量   | 加载 ~/.bashrc 等     | 几乎没有              |
| 工作目录   | 当前目录              | 用户 home 目录         |
| 输出      | 终端显示              | 邮件发给用户（常丢失）  |
| Shell     | 交互式登录 shell      | 非交互式非登录 shell   |
```

8 大常见坑及修复：
```bash
# 坑 1：命令没写绝对路径（最常见）
# 错误：
* * * * * python3 backup.py
# crontab 找不到 python3，也找不到 backup.py
# 正确：
* * * * * /usr/bin/python3 /home/user/scripts/backup.py

# 坑 2：环境变量缺失
# crontab 里没有你在 ~/.bashrc 中定义的变量
# 修复：在 crontab 顶部定义
PATH=/usr/local/bin:/usr/bin:/bin
BACKUP_DIR=/data/backup
* * * * * /home/user/scripts/backup.sh

# 坑 3：脚本没有执行权限
chmod +x /home/user/scripts/backup.sh

# 坑 4：最后一行没有换行符
# crontab 要求每行以换行结尾，否则最后一行任务被忽略
# 编辑后用 cat -A 确认

# 坑 5：% 号没有转义
# 错误：
* * * * * date +%Y-%m-%d >> /tmp/date.log
# crontab 中 % 是特殊字符，必须转义
# 正确：
* * * * * date +\%Y-\%m-\%d >> /tmp/date.log

# 坑 6：输出没有重定向
# crontab 的输出默认发邮件，如果没配邮件服务就丢失了
# 正确：重定向到日志文件
* * * * * /home/user/scripts/backup.sh >> /var/log/backup.log 2>&1

# 坑 7：时区不对
# crontab 使用系统时区，可能和预期不同
timedatectl

# 坑 8：脚本依赖终端交互
# 如 read 等待输入、tput 操作终端，crontab 里都没有终端
```

排查流程：
```bash
# 1. 查看 crontab 是否注册
crontab -l

# 2. 查看 cron 服务是否运行
systemctl status cron    # Ubuntu
systemctl status crond   # CentOS

# 3. 查看 cron 执行日志
sudo grep CRON /var/log/syslog     # Ubuntu
sudo grep CROND /var/log/cron      # CentOS

# 4. 临时测试：每分钟执行一次
* * * * * /home/user/test.sh >> /tmp/crontest.log 2>&1
# 等 1 分钟看日志

# 5. 模拟 crontab 环境执行脚本
env -i /bin/bash /home/user/scripts/backup.sh
# env -i 清空所有环境变量，模拟 crontab 的极简环境
```

补充说明：
- 规则：crontab 中所有路径必须写绝对路径，输出必须重定向到日志
- 2>&1 把标准错误也重定向到日志文件，否则错误信息丢失
- 复杂任务建议用 systemd timer 替代 crontab，功能更强
- crontab 最小粒度是分钟，秒级任务需要其他方案