ENGINEERING PLAYBOOK

Cron 表达式常用示例

示例只有在明确调度器实现和时区后才有意义。页面把表达式、自然语言解释、验证命令和失败观察放在一起，避免只复制一行配置。

适用人群：需要把业务时间表转换为可验证 cron 表达式的开发与运维人员

排查路径

  1. 从业务要求写出自然语言时间表。
  2. 转换为当前实现支持的字段。
  3. 列出未来三个预期触发时间。
  4. 通过日志和任务结果分别验收。

执行步骤

  1. 先使用无副作用命令验证触发。
  2. 记录调度器读取配置的时间。
  3. 月末任务要处理月份天数差异。
  4. 跨时区任务统一使用明确时区。
  5. 任务失败应有独立告警而不是等待下一次。

可复制命令与示例

每小时第十分钟

10 * * * * /usr/local/bin/hourly

每月一日六点

0 6 1 * * /usr/local/bin/monthly

可复现任务记录

具体错误或任务

表达式看似正确但触发时刻偏移，需要先固定 cron 实现、字段数和时区。

失败信号：日志触发时间与预期相差一个时区，或六字段表达式被五字段 crontab 拒绝。

最小输入

业务要求：服务器时区 Asia/Shanghai，每小时第 10 分钟执行一次无副作用检查。

验证命令或步骤

printf '%s\n' '10 * * * * /usr/local/bin/hourly-check' | crontab -

预期输出

crontab -l 原样显示五字段表达式，后续三个触发点均落在每小时第 10 分钟。

失败输出

bad minute、字段错位，或日志时间按 UTC 记录却被解释为本地时区。

成功判据

配置、系统时区与任务日志能对应三个连续预期触发点，失败告警独立于下一次调度。

本任务常见错误

  • 混用五字段和六字段语法
  • 未记录系统与业务时区
  • 用有副作用任务直接试跑

资料与适用边界

字段语义以目标系统的 crontab(5) 手册为准；云调度器和应用框架可能使用不同字段与时区规则。

证据块复核日期：2026-09-04

相关站内页面

资料依据与复核边界

资料复核日期：2026-08-29