Cron 任务管理最佳实践：从创建到监控

命名规范

好的任务命名应该一眼看出「做什么」和「何时做」：

{
  "daily-morning-report": { "schedule": "0 9 * * *" },
  "weekly-backup-postgres": { "schedule": "0 2 * * 0" },
  "five-min-health-check": { "schedule": "*/5 * * * *" }
}

任务模板

每个任务应包含以下字段：

{
  "name": "daily-morning-report",
  "schedule": "0 9 * * *",
  "task": "生成每日数据报告并发送",
  "timeout": 300,
  "retry": 2,
  "alertOnFailure": true,
  "alertChannel": "#ops-alerts"
}

依赖编排

有些任务有先后顺序，比如「先备份数据库，再上传到 S3」：

方案一：拆成两个任务，第二个任务开头检查第一个的完成状态

方案二：合并为一个任务，用 && 串联

{
  "schedule": "0 2 * * *",
  "task": "先执行 pg_dump 备份数据库，确认成功后再上传到 S3"
}

错误处理

1. 设置超时：所有任务都加 timeout，防止卡死
2. 失败重试：网络类任务建议重试 2-3 次
3. 告警通知：配合 Slack/Email Skill，失败时自动告警
4. 幂等设计：任务重复执行不会产生副作用

监控清单

• 每日任务成功率 > 99%
• 任务平均耗时无异常增长
• 失败告警 5 分钟内到达
• 过期任务定期清理

常见坑

1. 时区混淆：cron 用 UTC，记得换算本地时间
2. 任务堆积：上一个还没跑完，下一个又启动了
3. 静默失败：错误没被捕获，以为任务正常执行
4. 资源争抢：多个重任务同时跑，机器扛不住