beego/toolbox.AddTask不执行的最常见原因是未调用toolbox.StartTask()或主goroutine立即退出；需确保StartTask在AddTask后调用，并用select{}等保持主函数运行。
beego/toolbox.AddTask 为什么加了不执行
最常见原因是没调用 toolbox.StartTask()，或者调用后主 goroutine 立即退出。beego 的定时任务依赖后台 goroutine 持续运行，main() 函数结束会导致整个进程退出，任务自然停摆。
必须确保：
– toolbox.StartTask() 在所有 AddTask 之后调用
– 主函数不能直接返回，得用 time.Sleep、select{} 或信号监听等方式保持运行
– 若集成在 beego 应用中（非裸 main），应放在 func main() 末尾或 app.Run() 之前
- 错误写法：
toolbox.AddTask("log", tk); return—— 任务注册完就退出 - 正确写法：
toolbox.AddTask("log", tk); toolbox.StartTask(); select{} - Beego Web 应用中，推荐在
app.Run()前启动，避免被框架生命周期干扰
spec 字符串格式：6 字段 vs 5 字段，秒级支持要手动开
beego/toolbox 默认使用 5 字段 cron 表达式（分 时 日 月 周），不包含秒。写成 "* * * * *" 是每分钟执行一次，但具体哪一秒触发不可控；若想“每 5 秒执行”，不能写 "*/5 * * * * *"（6 字段），会解析失败报错 parse error: too many fields。
解决办法只有两个：
– 改用 time.Ticker 手动实现秒级轮询（适合简单场景）
– 或放弃 toolbox，换 robfig/cron/v3 并启用 cron.WithSeconds()
立即学习“go语言免费学习笔记（深入）”；
-
"0/5 * * * *"→ 每分钟第 0、5、10…55 秒各执行一次？错，这是无效语法 -
"0/5 * * * *"实际含义是「每 5 分钟的第 0 分钟」，即每小时 0、5、10…55 分各一次 - 真正想要每 5 秒跑一次，toolbox 不支持，别硬凑 spec
任务函数 panic 会导致整个调度器静默崩溃
beego/toolbox 内部没有 recover 机制。一旦你传入的 task 函数里发生 panic（比如空指针解引用、数据库连接失败未判空），整个 toolbox.StartTask() 启动的 goroutine 会退出，后续所有任务全部停止，且无日志、无提示、不报警。
必须在任务函数内部自行兜底：
- 用
defer func() { if r := recover(); r != nil { log.Printf("task panic: %v", r) } }() - 所有外部依赖（DB、HTTP、文件）调用前加超时和错误检查
- 避免在 task 函数里直接调用
log.Fatal或os.Exit
这不是建议，是上线前必须加的防护。生产环境见过太多因为一条日志没判 err 导致整站定时任务瘫痪的情况。
动态增删任务要用 AddTask/RemoveTask，但没提供 EntryID 管理
beego/toolbox 的 AddTask 和 RemoveTask 都基于任务名（string）操作，不返回句柄，也不暴露内部 map 结构。这意味着：
- 无法安全地并发增删（没锁，多 goroutine 调用可能 panic）
- 重名任务会被覆盖，且旧任务不会自动 stop
- 没法查某个任务当前是否正在运行
如果真需要动态控制，务实做法是：
– 自己用 sync.Map 缓存 *toolbox.Task 实例
– 增删前加 sync.RWMutex
– 删除时先调 tk.Stop() 再从 map 清除
– 别依赖 toolbox 自带的 RemoveTask 做线上热更
复杂度上来后，不如直接切到 robfig/cron/v3——它返回 cron.EntryID，支持 cron.Remove + 加锁封装，时区、秒级、context 取消都原生支持，维护成本反而更低。
