debian 定时器怎么故障排除

Debian 定时器故障排查速查

一 快速判断与定位

• 明确使用的是哪类定时器：
  • systemd 定时器：由 .timer 单元 + .service 单元 组成，适合精确到秒/日历的调度。
  • cron：传统的按分钟级调度，适合简单周期任务。
• 快速健康检查命令：
  • systemd 定时器：
    • 查看所有定时器与下次触发时间：systemctl list-timers --all
    • 查看具体定时器状态：systemctl status your-job.timer
    • 查看定时器详细属性（如 OnCalendar、Next Elapse）：systemctl show your-job.timer
    • 查看日志：journalctl -u your-job.timer -b（加 -e 实时跟踪）
  • cron：
    • 查看当前用户任务：crontab -l；系统级任务：cat /etc/crontab 与 ls /etc/cron.d/
    • 查看服务状态：systemctl status cron
    • 查看执行日志：grep CRON /var/log/syslog
• 若发现定时器未触发，优先核对：服务是否运行、单元文件是否启用、下次触发时间是否合理、日志是否有报错。

二 systemd 定时器排查清单

• 配置与生效：
  • 确认 .timer 与 .service 成对存在，且 .service 的 ExecStart 指向正确的可执行文件。
  • 修改后执行：systemctl daemon-reload，然后 systemctl restart your-job.timer；需要开机自启则 systemctl enable your-job.timer。
• 时间与日历：
  • 用 systemctl show your-job.timer 检查 OnCalendar 是否符合预期；用 list-timers 确认 Next Elapse 时间。
  • 校对系统时间与时区：timedatectl status；时区错误会导致“到点不跑”。
• 日志与手动验证：
  • 查看定时器与服务的日志：journalctl -u your-job.timer -u your-job.service -b。
  • 手动触发一次服务验证：systemctl start your-job.service（排除脚本/权限问题后再回到定时器）。
• 常见原因：
  • OnCalendar 格式错误、服务单元未启用/未启动、脚本无执行权限、依赖服务未就绪、时区/时间错误。

三 Cron 排查清单

• 服务与任务：
  • 确认 cron 运行：systemctl status cron；未运行则 systemctl start cron。
  • 列出任务：crontab -l（当前用户），系统任务在 /etc/crontab 与 /etc/cron.d/。
• 语法与环境：
  • 校验时间字段：分 时 日 月 周（5 列）；命令与脚本尽量使用绝对路径。
  • cron 环境精简，建议在 crontab 顶部显式设置 PATH，脚本内也设置必要环境变量。
• 权限与路径：
  • 脚本需可执行：chmod +x /path/to/script.sh；被调度命令用绝对路径（如 /usr/bin/python3）。
• 日志与输出：
  • 查看执行记录：grep CRON /var/log/syslog；若有输出/报错，cron 通常会尝试发到本地邮件（检查 /var/mail/$USER）。
• 快速自测：
  • 临时任务验证：echo " * * * * echo ‘cron-test’ >> /tmp/cron_test.log 2>&1" | crontab -*；1 分钟后检查 /tmp/cron_test.log。

四 常见症状与修复对照表

五 实用命令清单

• systemd 定时器
  • 列表与状态：systemctl list-timers --all；systemctl status your-job.timer
  • 详细属性：systemctl show your-job.timer
  • 生效变更：systemctl daemon-reload；systemctl restart your-job.timer；systemctl enable your-job.timer
  • 日志：journalctl -u your-job.timer -u your-job.service -b -e
• cron
  • 任务与系统任务：crontab -l；cat /etc/crontab；ls /etc/cron.d/
  • 服务与日志：systemctl status cron；grep CRON /var/log/syslog
• 时间与时区
  • 查看与设置：timedatectl status；timedatectl set-timezone Asia/Shanghai
• 快速验证
  • 临时 cron 任务：echo " * * * * echo ‘test’ >> /tmp/cron_test.log 2>&1" | crontab -*
  • 手动触发服务：systemctl start your-job.service