Linux 日历定时任务怎么补跑：OnCalendar、Persistent 与 journalctl 实战

服务器上的日报任务如果只是写在 crontab 里，排查时经常要同时核对 PATH、工作目录、运行用户和散落在各处的日志。对已经由 systemd 管理的 Linux 服务，我更建议把定时触发也交给 systemd：用一个同名的 .timer 调起 .service，用 OnCalendar 定义执行时间规则，用 Persistent=true 处理关机期间错过的日历触发任务，后续直接用 journalctl 统一回看全链路运行结果。

先判断：这类任务适不适合交给 systemd

如果任务已经配套了稳定的服务单元、需要统一管控状态和日志，或者服务器重启后不能悄悄漏掉一次日报生成，systemd timer 比用户级 crontab 更容易在团队内交接。它的代价也很明确：需要维护两个 unit 文件，并且要提前妥善处理服务用户、工作目录、权限和重复运行的相关规则。

用一对 unit 文件替换一行 crontab 配置

下面用每天 02:30 生成报表作为例子。先创建服务文件，命令全部使用绝对路径，避免 systemd 的精简环境和登录 shell 环境不一致导致的异常。

[Unit]

[Service]
Type=oneshot
User=reporter
WorkingDirectory=/srv/report
# 启动命令字段：/usr/local/bin/report-daily --output /srv/report/out/daily.csv

把它保存为 /etc/systemd/system/backup-report.service。对应的 timer 触发配置文件如下：

[Unit]

[Timer]
OnCalendar=*-*-* 02:30:00
Persistent=true
AccuracySec=1min
Unit=backup-report.service

[Install]
WantedBy=timers.target

Unit= 可以省略，因为同名 timer 默认会启动同名 service；这里保留它，是为了让关联关系在交接时一眼就能看清。AccuracySec=1min 表示触发允许落在一段可接受的时间窗口内，不应把它当成精度极高的实时闹钟。

启用之前先验算 OnCalendar 配置

不要直接 enable 后等第二天再验证结果。先让 systemd 解析表达式，确认下一个触发点和主机当前时区匹配：

systemd-analyze calendar '*-*-* 02:30:00'
sudo systemctl daemon-reload
sudo systemctl enable --now backup-report.timer
systemctl list-timers backup-report.timer --all

如果输出的下次触发时间和预期差了几个小时，先排查时区配置和时间同步状态，不要急着修改日历字符串。带有 OnCalendar 的 timer 会依赖系统时间设置；容器、虚拟机和刚启动的主机尤其值得做这一步检查：

timedatectl status
systemctl status systemd-timesyncd --no-pager

Persistent 补跑什么，不能补跑什么

设为 Persistent=true 后，systemd 会记录 timer 最近一次成功触发的时间。主机在本来应该触发的时间处于关机状态，随后 timer 被重新激活时，对应服务会被自动触发一次。这个语义是“只要至少错过过一次执行就补跑一次”，不是把停机期间的每个周期都补成一串连续任务。

因此报表、清理、同步类任务本身必须支持重复运行。写文件时先写临时文件再原子改名，向数据库写入时用业务日期做唯一键；如果一次补跑和正常调度的触发时间点靠近，还要在服务内加锁或者用幂等记录挡住重复处理逻辑。

三条命令把“没执行”拆成三个独立问题

遇到日报没有生成，按下面的顺序排查，能把“触发时间没到点”“timer 没正常排程”和“service 运行后失败”三类问题分开定位：

如果手动运行程序完全正常、由 timer 调起却失败，优先比对 User=、WorkingDirectory=、启动命令字段、输入文件权限和输出文件夹权限。这里别直接把服务改成 root 身份运行；随意扩大权限会掩盖真正的部署配置缺口。

常见问题

systemd timer 能完全替代所有 crontab 吗？

不能简单地说完全替代。个人临时脚本用 crontab 配置成本更低；已经纳入 systemd 管理的服务，则更适合把触发、状态和日志放在同一套 unit 体系里统一管理。

Persistent=true 会不会把停机期间的任务全部补齐？

不会。它的用途是 timer 重新激活后，对错过的日历触发进行一次补跑；如果业务需要按逐日维度补账，应由应用本身根据业务日期自行补齐缺失数据。

为什么 list-timers 显示的时间和预期不完全一样？

先检查主机时区配置，再看 AccuracySec 配置。日历表达式的触发不是绝对零偏差的闹钟，时间同步状态和允许的延迟窗口都会影响实际触发时刻。

timer 启动了但 service 没有再次运行怎么办？

检查 service 是否仍处于 active 状态。对于重复触发的任务，Type=oneshot 的配置逻辑更直观；若服务长期保持 active 状态，timer 到点时可能不会再次启动同一个已处于运行状态的单元。

落地前的最小检查清单

把 unit 文件放进生产环境前，至少核对四件事：服务运行用户能正常读写目标文件夹；程序使用绝对路径且工作目录明确配置；任务重复运行不会破坏业务结果；首次启用后能从 list-timers 和 journalctl 找到完整的运行记录证据。做到这一步，systemd timer 才不只是把 crontab 换了个存储文件名，而是把调度、补跑和故障定位流程真正收进了统一的服务管理体系。