在goframe框架中编写定时任务,核心是调用 gcf.new() 创建调度器实例,并使用 .start() 方法启动后台协程。你需要通过 .add() 方法将具体的业务逻辑函数注册到调度器中,并传入标准的 cron 表达式字符串来定义执行频率。这样配置后,框架会自动根据表达式在指定时间触发对应的处理函数,无需手动管理循环或休眠。

如何定义单次执行与固定间隔的任务
对于只需要运行一次或在固定毫秒数后重复执行的任务,可以直接使用特殊的 Cron 表达式或辅助方法。单次执行可以使用 @every 1s 这种格式配合 gcf 的解析逻辑,或者更简单地直接使用 time.AfterFunc 结合 GoFrame 的上下文。但在 gcf 中,通常推荐使用标准 Cron 表达式来实现固定间隔,例如每5秒执行一次可以使用 0/5 * * * * ?。这种方式不需要引入额外的第三方库,直接利用内置的调度能力即可实现简单的轮询逻辑。

package main
import (
"context"
"github.com/gogf/gf/v2/frame/g"
"github.com/gogf/gf/v2/os/gcf"
"github.com/gogf/gf/v2/os/glog"
)
func main() {
// 1. 创建调度器实例
c := gcf.New()
// 2. 注册一个每5秒执行一次的定时任务
// 表达式: 秒 分 时 日 月 周
// 0/5 * * * * ? 表示从第0秒开始,每5秒执行一次
c.Add("0/5 * * * * ?", func(ctx context.Context) {
glog.Info(ctx, "Fixed interval task executed at:", time.Now())
})
// 3. 启动调度器(非阻塞)
c.Start()
// 保持主进程运行
select {}
}
上述代码展示了最基础的固定间隔任务实现。输入为空的初始化上下文,实际结果是调度器在后台启动,每隔5秒打印一次日志。注意 c.Start() 是异步执行的,主程序必须通过 select {} 或其他方式阻塞,否则主进程退出会导致调度器停止。这里的表达式 0/5 * * * * ? 是标准的 Quartz Cron 格式,GoFrame 内部集成了该解析器。
如何处理复杂的时间点调度与冲突
当需要精确到特定时间点(如每天凌晨2点)或处理多个任务可能产生的资源竞争时,需要更精细地配置 Cron 表达式并考虑任务的执行上下文。复杂调度通常涉及“日”、“月”或“周”的限制,例如 0 0 2 * * ? 表示每天凌晨2点整执行。如果多个任务在同一时刻触发,它们会在不同的 Goroutine 中并发执行,因此共享资源时需要加锁。此外,可以通过 gcf.NewWithCtx() 传入自定义 Context 来控制任务的超时或取消行为,确保在系统关闭时能优雅终止正在运行的任务。

gcf











