最稳路径是显式启用秒级支持、强制校验表达式、封装为cron.Job、Start后defer Stop；AddFunc易漏跑因闭包捕获变量、panic未recover、无超时控制及日志无上下文。
用 robfig/cron/v3 实现定时清理任务，最稳的路径是：显式启用秒级支持（哪怕不用秒）、强制校验表达式、每个任务封装为 cron.Job 而非裸闭包、c.Start() 后必须配 defer c.Stop()。直接用 AddFunc 写清理逻辑，90% 的线上漏跑都出在时区、解析静默失败或 panic 未 recover。
为什么 AddFunc 容易导致清理任务漏跑
AddFunc 看似简单，但清理类任务（如删过期日志、清 Redis 缓存）往往耗时、可能 panic、依赖外部状态——这些都会放大风险：
- 闭包捕获循环变量：
for _, path := range paths { c.AddFunc("@daily", func() { os.RemoveAll(path) }) }最终所有任务都删最后一个path - panic 不处理：一个
os.RemoveAll权限错误会终止整个调度器，后续所有清理任务停摆 - 无超时控制：若
os.RemoveAll("/huge/log/dir")卡住 5 分钟，下一轮 @daily 就被跳过（v3 默认不跳过） - 日志无上下文：只打印 “panic: permission denied”，无法定位是哪个路径、哪个任务出的问题
用 cron.Job 封装清理任务的最小可行写法
把清理逻辑拆成结构体，实现 Run() 方法，天然支持字段传参、状态跟踪和错误隔离：
type LogCleaner struct {
Dir string
MaxAge time.Duration
Logger *log.Logger
}
<p>func (l *LogCleaner) Run() {
defer func() {
if r := recover(); r != nil {
l.Logger.Printf("LogCleaner panic: %v", r)
}
}()</p><pre class="brush:php;toolbar:false;">ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
defer cancel()
// 实际清理逻辑放这里，用 ctx 控制超时
if err := cleanOldLogs(ctx, l.Dir, l.MaxAge); err != nil {
l.Logger.Printf("clean logs failed: %v", err)
}}
注册时直接传实例：c.AddJob("@daily", &LogCleaner{Dir: "/var/log/myapp", MaxAge: 7 * 24 * time.Hour, Logger: log.Default()})
表达式校验和时区陷阱必须手动堵死
清理任务对时间敏感，但 robfig/cron/v3 的默认行为极易踩坑：
- 表达式少一段就静默失败：
c.AddFunc("0 0 * *", ...)（4 段）不会报错，但任务永远不会触发；必须用cron.ParseStandard("0 0 * * *")主动校验返回 error - Docker 镜像里没
tzdata，time.Local退化成 UTC：本地测试是每天 0 点删日志，上线后变成每天 8 点（UTC 0 点 = CST 8 点） - 想每 2 小时清理一次，误写成
"0 0/2 * * *"（非法语法），正确是"0 */2 * * *"
初始化时强制指定时区：c := cron.New(cron.WithLocation(time.FixedZone("CST", 8*60*60)))，比依赖系统时区更可靠。
进程退出时清理资源的硬性要求
清理任务常涉及文件句柄、DB 连接或临时目录，c.Stop() 不只是停止调度，更是释放资源的关键时机：
-
c.Stop()会等待正在运行的 job 结束（默认最多 10 秒），防止删到一半被 kill - 必须在
c.Start()后立即defer c.Stop()，否则主 goroutine 退出时 goroutine 被强制终止，os.RemoveAll可能中断在中间 - 如果清理任务自己开了 goroutine（比如并发删多个子目录），需在
Run()里监听c.Stop()发出的信号，主动退出子协程
真正容易被忽略的是：清理任务本身可能创建了需要关闭的资源（如打开的锁文件、临时数据库连接），这些不能指望 cron 自动处理，得在 Run() 结尾显式 close 或 unlink。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
