recover仅能捕获当前goroutine内由panic触发的运行时异常(如空指针、越界、除零),无法处理SSE连接中断等I/O错误;后者应通过检查context.Done()和Write/Flush返回的error来响应并正常退出。

recover 不是用来重连 SSE 连接的,它也不能捕获连接中断这类错误。
Go 的 recover 只能捕获当前 goroutine 中由 panic 触发的运行时异常(比如空指针解引用、切片越界、除零等),而 SSE 连接中断是网络 I/O 层面的正常事件:客户端关闭、代理切断、超时断连、写入失败……这些都会表现为 write 或 flush 返回非 nil error,属于可预期的控制流分支,不是 panic。
所以,用 recover 去“处理 SSE 断连”不仅无效,还会掩盖真实问题,甚至导致 goroutine 泄漏或资源未释放。
为什么你会想到用 recover?常见误解来源
很多人看到日志里有 panic: write tcp ... broken pipe 就以为这是 panic,想用 recover 拦住。但这个 panic 通常不是你代码主动触发的,而是 net/http 在底层 write 失败后,被某些未加保护的 log.Fatal 或第三方库误转成 panic —— 这属于错误的错误处理方式,不是 SSE 协议本身的问题。
真正该拦截和响应的:I/O 错误和 context 取消
SSE Handler 的健壮性,核心在于对以下两类信号的及时响应:
-
context.Context.Done():客户端关闭连接、浏览器标签页关闭、AbortController.abort() 都会触发该 channel 关闭 -
http.ResponseWriter.Write()或http.Flusher.Flush()返回的 error:如io.ErrClosedPipe、net.ErrClosed、http.ErrHandlerTimeout
这两类信号必须在每次写入前/后检查,一旦出现,应立即退出 handler,清理资源(比如关闭上游连接、cancel 下游 ctx)。
文件删除恢复功能 v0.8.0:删除前自动备份文件(存至 `delete_backup/YYYYMMDDHHMM/` 目录),支持从备份中恢复、通过清单(manifest)搜索。具备 SHA256 完整性校验、路径遍历防护及工作区根目录(workspace-root)访问限制。支持自动清理 7 天 / 30 天前的备份。 **v0.8.0:新增 `workspace_cleaner` —— 支持定时清理临时文件,并在删除前自动执行备份。** **v0.7.0:`allowed_roots` 默认值
Go SSE Handler 中正确的“重连”逻辑在哪?
注意:“重连”不是服务端的事——SSE 协议规定,重连由客户端(EventSource)自动发起,服务端只需配合:
- 确保每次响应都带
Content-Type: text/event-stream和Cache-Control: no-cache - 在连接建立时返回一个
id:字段(用于客户端记录最后接收位置) - 在空闲期发送注释行(
: keep-alive\n\n)维持连接,避免代理超时切断 - 当检测到写入失败时,**不 panic,不 recover,而是 return** —— 让 http.Server 正常关闭该连接,等待客户端按
retry:指令重连
示例关键片段:
func sseHandler(w http.ResponseWriter, r *http.Request) {
ctx := r.Context()
flusher, ok := w.(http.Flusher)
if !ok {
http.Error(w, "streaming unsupported", http.StatusInternalServerError)
return
}
<pre class="brush:php;toolbar:false;">w.Header().Set("Content-Type", "text/event-stream")
w.Header().Set("Cache-Control", "no-cache")
w.Header().Set("Connection", "keep-alive")
// 每 30s 发一次心跳,防止 Nginx proxy_read_timeout 切断
ticker := time.NewTicker(30 * time.Second)
defer ticker.Stop()
for {
select {
case <p>}</p>
容易被忽略的关键点
真正的生产级难点不在“怎么重连”,而在“怎么不让连接轻易断”以及“断了之后别拖垮服务”。最容易被跳过的三件事:
- Nginx 等代理层必须显式配置
proxy_read_timeout 300(或更高),否则默认 60 秒就切掉空闲 SSE 连接 - Go
http.Server的ReadTimeout/WriteTimeout必须禁用,它们会无差别杀死正在流式写入的连接 - 每个 SSE handler goroutine 必须绑定独立的
context.WithTimeout或context.WithCancel,用于控制总存活时间或级联取消上游 LLM 请求
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










