必须设置Content-Type: text/event-stream、Cache-Control: no-cache、Connection: keep-alive三个响应头,缺一则EventSource卡在connecting状态;每次写data后须立即调用http.Flusher.Flush()确保流式输出。

必须设置的三个响应头:Content-Type、Cache-Control、Connection
浏览器只认 Content-Type: text/event-stream,缺了它,EventSource 会卡在 connecting 状态;Cache-Control: no-cache 防止代理或浏览器缓存初始响应,导致后续事件不触发;Connection: keep-alive 是显式声明长连接,否则 Nginx 或 ALB 可能中途切断。这三个头必须在第一次写入前设好,顺序无关,但漏一个就白搭。
每次写完 data: 后必须调用 http.Flusher.Flush()
Go 的 http.ResponseWriter 默认带缓冲,不手动 Flush(),数据就一直卡在内存里——前端永远收不到。常见错误是只在 handler 结尾 defer w.(http.Flusher).Flush(),这只会刷一次,起不到流式效果。
正确做法是:
- 先断言:
flusher, ok := w.(http.Flusher),!ok时应返回错误 - 每写一条
data: hello\n\n后立刻调用flusher.Flush() - 别用
c.SendString()—— Fiber v3 中要用c.Context().Response.BodyWriter()配合Flush()
Fiber v3 的 sse.New 中间件怎么用?
官方 sse 中间件封装了响应头、帧格式(event:/data:/retry:)、心跳注释和断连检测,但不处理广播逻辑或用户认证。
使用要点:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
Config.Handler是必需字段,接收*sse.Stream,调用stream.Event()发送事件 -
Retry参数控制重连间隔,如Retry: 5 * time.Second会在开头写入retry: 5000 - 心跳由中间件自动注入(默认每 15 秒发
: ping\n\n),无需手动写 - 断连检测依赖
Flush()返回的写错误,所以不能跳过 flush 步骤
为什么 goroutine 泄漏比格式错误更致命?
每个 SSE 连接对应一个长生命周期 goroutine。如果没监听 c.Context().Done() 就退出,客户端关掉页面后 goroutine 仍挂着,几天就 OOM。
线上必须同步配置:
- HTTP server 的
IdleTimeout和ReadTimeout设为 0 或大幅延长(如 5 分钟) - Nginx 的
proxy_read_timeout必须同步调大,否则空闲 60 秒就被掐断 - 别在 handler 里打
log.Printf—— 日志 I/O 可能阻塞 flush,导致客户端卡住
最易被忽略的是:心跳不是可选功能,而是穿透中间网络设备的必要手段;而断连清理必须靠 context + Flush 错误双重判断,缺一不可。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










