Revel 中需禁用自动响应、获取原始 ResponseWriter、设 SSE 头、逐行写入并 Flush;漏 event: 字段或格式错误致客户端收不到事件;须监听 request.Context().Done() 安全终止连接防泄漏。

Revel 中如何正确创建 SSE 连接(不是普通 HTTP handler)
Revel 默认的 Controller.Action 是短生命周期、响应即关闭的,直接在其中调用 WriteHeader + Write 发送事件会失败——连接很快被框架自动关闭,客户端收不到后续事件。必须绕过默认响应流,手动接管底层 http.ResponseWriter 并保持连接活跃。
关键做法是:在 Action 中禁用 Revel 的自动响应处理,获取原始 http.ResponseWriter,设置必要头,并持续写入带格式的事件数据。注意不能调用 render.JSON 或任何触发 FinishRequest 的方法。
- 在 Action 开头立即调用
c.Response.Out = nil,阻止 Revel 后续写入响应体 - 手动设置
Content-Type: text/event-stream和Cache-Control: no-cache - 写入每条事件后必须调用
Flush()(需类型断言为http.Flusher),否则数据滞留在缓冲区 - 避免使用
time.Sleep阻塞主线程;应配合context或 channel 控制发送节奏
为什么 EventSource 客户端收不到 event: message 字段
Revel 本身不解析或生成 SSE 格式,所有格式责任在开发者。常见错误是只写 "data: hello\n\n",但漏掉 event:、id: 或换行规则,导致浏览器 EventSource 无法识别事件类型。
SSE 协议要求每条消息以空行分隔,字段名必须小写,且 data: 行末不能有多余空格。浏览器只对匹配 event: xxx 的消息触发对应 addEventListener('xxx', ...) 回调。
- 正确格式示例:
"event: update\ndata: {\"id\":1}\n\n"(注意两个 \n) - 若省略
event:,浏览器默认归为message事件,需用source.onmessage接收 - 每条消息建议带
id:,便于客户端断线重连时请求Last-Event-ID - 不要用
fmt.Fprintf拼接多行字符串再写入,易丢失换行;逐行WriteString+Flush更可靠
如何安全终止长连接并避免 goroutine 泄漏
Revel 不管理长连接生命周期,一旦客户端断开(如关闭标签页),http.ResponseWriter 底层连接可能仍处于半开状态,goroutine 会持续运行直到超时或写入失败——这是最常见的资源泄漏点。
必须主动监听连接是否断开,并及时退出循环。Revel 的 Controller 没有内置上下文取消机制,需手动结合 http.Request.Context().Done() 判断。
- 在发送循环中定期检查
select { case - 不要依赖
defer关闭资源——连接已断时 defer 仍会执行,但此时Write可能 panic - 若使用后台 goroutine 推送(如监听 Redis Pub/Sub),务必用
sync.WaitGroup或 channel 控制启停,避免重复启动 - 测试时用
curl -N http://localhost:9000/events观察是否在 Ctrl+C 后服务端 goroutine 立即退出
Revel 2.0+ 中 middleware 对 SSE 的干扰问题
某些 Revel 中间件(如 SecureHeadersFilter、GzipFilter)会修改响应头或包装 ResponseWriter,导致 Flush() 失效或头信息被覆盖,SSE 连接直接中断。
最稳妥的方式是在路由层面绕过这些中间件。Revel 允许为特定路径禁用 filter,而不是全局关闭。
- 在
app/init.go的init()函数中,用revel.InterceptFunc绑定前先判断路径,对/events跳过 - 或在
conf/routes中为 SSE 路由单独配置GET /events Controller.Events,并在app/filters.go中排除该路径 - 调试时临时注释所有非必需 filter,确认 SSE 正常后再逐个启用验证
- 特别注意
GzipFilter:SSE 必须禁用压缩,否则Flush()无法穿透 gzip 缓冲
实际部署时 Nginx 默认会缓存 SSE 响应,必须显式配置 proxy_buffering off 和 proxy_cache off,否则客户端永远收不到实时事件。











