Go需用robfig/cron/v3解析Cron表达式,必须调用Start()启动调度器,支持秒级精度需WithSeconds(),时区设置用WithLocation(),panic需Recover避免停摆。

Go 里没有内置 Cron 解析器,得靠第三方库
标准库 time 不提供 Cron 表达式解析能力,crontab -e 那套语法(如 "0 */2 * * *") 必须借助外部库。最常用的是 robfig/cron/v3,它支持 RFC 标准(秒级可选)、时区、任务取消和错误回调,且活跃维护。别用已归档的 v2 版本——它不支持 Go Module 且缺少关键修复。
用 cron.New() 启动调度器前必须调用 Start()
常见错误是只调用 cron.New() 就以为调度开始,结果任务从不执行。实际流程是:
-
cron.New()返回未启动的调度器实例 - 必须显式调用
.Start()才真正启动后台 goroutine - 忘记
Start()会导致AddFunc()注册成功但零次触发
示例片段:
c := cron.New()
c.AddFunc("0 */5 * * *", func() { fmt.Println("每5分钟") })
c.Start() // ⚠️ 这行不能少
// 程序退出前建议 c.Stop() 避免 goroutine 泄漏
cron.WithSeconds() 决定是否支持秒级精度
默认情况下,robfig/cron/v3 使用 5 字段格式(分、时、日、月、周),不识别秒。若需 "30 * * * * *" 这类 6 字段表达式,必须传入 cron.WithSeconds() 选项:
- 没加该选项时,6 字段会被截断为后 5 位,导致语义错乱(例如
"30 * * * * *"变成"* * * * *") - 加了之后,首字段视为秒,支持精确到秒的调度
- 时区设置(如
cron.WithLocation(time.UTC))应与WithSeconds()同时传入,顺序无关
正确初始化方式:
c := cron.New(cron.WithSeconds(), cron.WithLocation(time.Local))
任务函数 panic 会导致整个调度器停止
这是生产环境最容易被忽略的风险点。robfig/cron/v3 默认不会 recover 任务中的 panic,一旦某个 job panic,调度器会打印错误并永久停止后续所有任务执行。
- 必须手动包装任务逻辑,用
defer/recover捕获 panic - 或使用
cron.WithChain(cron.Recover(cron.DefaultLogger))自动恢复(推荐) - 注意:即使用了
Recover,panic 仍会记录日志,需检查日志确认任务是否异常退出
不推荐裸写:
c.AddFunc("@every 10s", func() { panic("oops") }) // ⚠️ 调度器将停摆
复杂点在于:Cron 表达式本身不校验时间逻辑合理性(比如 "0 30 25 * *" 在 2 月可能永远不触发),而调度器也不会提前报错。得靠测试用例覆盖边界日期,或在任务中加运行时校验。











