Revel 不支持 @Scheduled 和已废弃的 revel.Jobs,应改用 time.Ticker 在生产环境启动 goroutine 实现简单定时任务,关键任务需剥离为独立 CLI 进程配合 cron 或 systemd 管理。

Revel 里不能用 @Scheduled 或 revel.Jobs
Revel 没有内置定时任务调度器,revel.Jobs 模块早在 2017 年就已废弃,当前主仓库中已彻底移除相关代码。你如果在旧教程里看到 job.RunEvery("30s") 或 revel.RegisterJob,直接跳过——它们在 Go 1.16+ 下会编译失败或 panic:undefined: revel.Jobs。这不是配置没写对,是根本不存在。
用 time.Ticker 启动 goroutine 是最简方案
适用于单实例、非关键型周期任务(如每 5 分钟刷新一次本地缓存、上报健康指标)。关键是要把它塞进 Revel 应用的生命周期里,且避免开发模式热重载时重复创建。
- 只在生产环境启动:
if revel.BUILD_MODE == "prod"包裹 ticker 启动逻辑 - 别在 controller 里启动——HTTP 请求结束不等于 goroutine 结束,容易泄漏
- 务必调用
ticker.Stop(),但注意:Revel 没有进程退出钩子,无法自动触发,所以 ticker 要设计为“可长期运行”,不要依赖优雅关闭 - 日志别用
revel.INFO.Println—— 热重载后 logger 可能未初始化,输出为空;改用标准库log.Printf更稳
示例片段(放在 app/init.go 的 init() 函数末尾):
if revel.BUILD_MODE == "prod" {
go func() {
ticker := time.NewTicker(5 * time.Minute)
defer ticker.Stop()
for range ticker.C {
log.Printf("cache refresh triggered at %v", time.Now())
// your logic here
}
}()
}需要强可靠?必须剥离到独立 CLI 进程 + cron
当任务要求“每天只执行一次,不管 Revel 进程启停多少次”,或者跨多实例需防重复,就不能和 Web 进程绑在一起。这时得自己补一个命令行入口,复用 Revel 配置但不启动 HTTP server。
- 新建
cmd/scheduler/main.go,调用revel.Init加载 conf,只初始化 DB/cache 模块,跳过 router 和 server - 用
flag解析--task=daily-report,按参数分发逻辑 -
cron条目必须用绝对路径:0 2 * * * cd /opt/myapp && /opt/myapp/cmd/scheduler/scheduler run --task=daily-stats >> /var/log/scheduler.log 2>&1 - 注意
cron默认 PATH 极窄,调用外部命令(如mysql)前要显式写全路径,或在 crontab 头部加PATH=/usr/local/bin:/usr/bin:/bin
别踩 systemd 重启策略的坑
如果你用 systemd 管理 Revel 进程,Restart=always 会导致新进程启动时旧 ticker 还没完全退出,两个 goroutine 同时跑相同任务。更隐蔽的是,revel.AppLog 在 goroutine 中可能因初始化顺序问题静默丢日志。
- 推荐 systemd 的
Restart=on-failure,配合StartLimitIntervalSec=60防止频繁崩溃循环 - 所有定时逻辑里避免直接操作 Revel 全局 logger,优先用
log或带 context 的自定义 logger 实例 - 如果任务涉及数据库写入,确保使用带 context 的方法(如
db.ExecContext(ctx, ...)),否则超时后连接可能卡住
真正难的不是怎么写定时逻辑,而是想清楚这个任务能不能丢、允不允许重复、是否跨实例——选错方案,后面八成时间都在修重试和去重逻辑。


















