不能用 GET 路由直接触发耗时任务,因 Buffalo 默认同步阻塞,会导致请求超时、连接堆积和重复触发;正确做法是路由仅发消息到异步队列(如 asynq),Worker 独立监听执行,避免共享 HTTP 上下文。

为什么不能用 app.GET("/task/run", RunTask) 直接触发后台任务
直接注册 GET 路由触发耗时任务,会导致 HTTP 请求长时间阻塞、超时、连接堆积,还可能被爬虫或误刷新反复触发。Buffalo 默认的请求生命周期是同步阻塞的,c.Next() 返回前整个 goroutine 卡住,无法退回到事件循环——这不是“后台”,只是“前台慢动作”。
正确做法:用异步队列 + 立即返回的触发端点
Buffalo 本身不带任务队列,但可以无缝接入标准 Go 生态方案(如 github.com/hibiken/asynq 或 github.com/robfig/cron)。关键在于:路由只负责“发消息”,不执行任务逻辑。
- 定义一个轻量 Action:
func TriggerTask(c buffalo.Context) error,里面只做三件事:构造任务 Payload、推入 Redis 队列、返回c.Render(202, r.JSON(map[string]string{"status": "queued"})) - 在
app.go初始化阶段启动独立的 worker goroutine(不要挂进 Buffalo 的 HTTP handler 链),监听队列并执行真实逻辑 - 确保该 worker 不依赖
buffalo.Context——它没有 request/response,只有asynq.Task和你自己的 DB 连接 - 别把数据库事务(
pop.Transaction)或 session(c.Session())传进 worker;要用app.DB或新建连接
buffalo g resource task_trigger 是个坑,别用
生成的 resource 默认带完整 CRUD 模板渲染和 r.HTML(),而触发任务根本不需要 HTML 响应,也不需要 models.TaskTrigger 这种冗余模型。手动写一个最小 Action 更安全:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
func TriggerDailyReport(c buffalo.Context) error {
payload := map[string]interface{}{
"type": "daily_report",
"user_id": c.Param("user_id"),
}
_, err := asynqClient.Enqueue(asynq.NewTask("report:generate", payload))
if err != nil {
return errors.WithStack(err)
}
return c.Render(202, r.JSON(map[string]string{"status": "submitted"}))
}
然后注册为 app.Post("/api/v1/tasks/trigger", TriggerDailyReport)——用 POST 语义明确表示“有副作用”,避免被缓存或预加载。
容易忽略的部署细节
worker 进程必须和主 HTTP 进程分离部署,否则 buffalo dev 重启时 worker 会中断;生产环境建议用 systemd 或 supervisor 管理独立的 worker 二进制。Redis 地址、重试策略、并发数这些配置项绝不能硬编码在 Action 里,要从 env 或 config.yml 加载。最常漏的是:没给 worker 设置 context.WithTimeout,导致某个卡死任务拖垮整个队列消费能力。


















