Buffalo注册SSE handler必须手写func(c buffalo.Context) error函数,显式调用app.GET("/events", handler),禁用c.Render(),全程操作c.Response()设置text/event-stream头并手动Write数据。

Buffalo 路由如何注册 SSE handler
SSE(Server-Sent Events)在 Buffalo 中不能用 c.Render(),必须注册为普通 buffalo.Handler 并手动管理响应流;路由需显式调用 app.GET("/events", eventsHandler),不能依赖 resources 自动生成。
Buffalo 的 buffalo g resource 生成的 CRUD 路由默认返回 JSON 或 HTML,不支持长连接和流式写入。SSE 要求响应头 Content-Type: text/event-stream、禁用缓存、保持连接打开,这些都与 c.Render() 的封装逻辑冲突。
- 必须手写 handler 函数,签名是
func(c buffalo.Context) error - 注册时直接传函数名:
app.GET("/events", eventsHandler),不要包在tasks.Resource里 - 别在 handler 开头调
c.Request().ParseForm()或json.Decode()—— SSE 通常是 GET 请求,无 body,解析反而可能阻塞 - 若需带参数(如
/events?topic=alerts),用c.Request().URL.Query().Get("topic")读取,无需中间件干预
handler 内如何正确设置 SSE 响应头和写入流
关键不是“开启流”,而是避免 Buffalo 自动关闭连接或覆盖 header —— 必须跳过 c.Render(),全程操作 c.Response(),且只调一次 WriteHeader(200)。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 先设 header:
c.Response().Header().Set("Content-Type", "text/event-stream") - 禁用缓存:
c.Response().Header().Set("Cache-Control", "no-cache")和c.Response().Header().Set("Connection", "keep-alive") - 调
c.Response().WriteHeader(200)—— 这步必须在任何Write()前,且只能调一次 - 用
c.Response().Write([]byte("data: ...\n\n"))发送事件,每条以data:开头,结尾双换行 - 别用
fmt.Fprintln(c.Response(), ...)—— 它可能触发隐式WriteHeader(),导致 panic
如何避免连接被 Buffalo 中间件或超时机制中断
Buffalo 默认中间件链(如 logger、gzip、CORS)多数兼容 SSE,但两个环节会主动终止长连接:HTTP 超时和中间件提前返回。
-
middleware.Logger会等 handler 返回才打日志,不影响流;但它依赖WriteHeader()被调用,否则日志中状态码为 0 - 别在 handler 里调
c.Error(500, err)或c.Render()—— 会立即结束响应,断开 SSE 连接 - 确保
PORT环境变量对应的服务端口没被反向代理(如 Nginx)加默认 timeout(常见 60s),需显式配proxy_read_timeout 300; - Go HTTP server 默认 idle timeout 是 30s,若你用
buffalo dev,它基于http.Server,需在app.go中改app.Serve()的IdleTimeout字段
客户端接收 SSE 时 Buffalo 后端要注意什么
前端用 new EventSource("/events") 时,Buffalo 后端只需保证流不断、格式合法;但容易忽略重连控制和错误传播路径。
- 服务端可发
retry: 3000\n控制客户端重试间隔(单位毫秒),写法:c.Response().Write([]byte("retry: 3000\n\n")) - 别在 handler 中用
defer c.Request().Body.Close()—— SSE 是 GET,无 body,且buffalo.Context已管理生命周期 - 若 handler 因 panic 退出,连接会断,但客户端会自动重连;建议用
recover()捕获并写event: error\ndata: ...\n\n通知前端 - 多个并发 SSE 连接会占用 goroutine,需注意内存和连接数限制;Buffalo 不提供连接池或限流内置能力,得自己加
sync.WaitGroup或 channel 控制
SSE 流的生命周期完全由 handler 函数控制,一旦函数 return,连接就关闭。这意味着你不能靠 “后台 goroutine 异步推送” 来维持流 —— 那样会导致 handler 提前退出,而 goroutine 写响应体时 panic。真要广播事件,得用 channel + for-select 阻塞在 handler 内部。










