现象
页面用 EventSource 订阅服务端推送,跑一段时间后连接悄悄断开,控制台没有任何报错,onerror 只触发一次就再也不重连,消息面板停在最后一条,只有刷新页面才恢复。服务端日志里能看到连接被关闭,但客户端没有发起新的请求。
原因
浏览器对 SSE 的自动重连带明确规则:收到 HTTP 204 会停止重连,收到非 200 状态或者错误的 Content-Type 也会关闭连接。网关超时、会话过期时服务端返回 204 或 502,客户端就再也不发了。另外在 onerror 里手动调用 close(),同样会让默认重连机制失效。
解决步骤
第一步,服务端统一返回 200 和 text/event-stream。不要用 204 表示没有新消息,需要保活时发送一行注释即可,注释不会触发 message 事件但能维持连接。
res.writeHead(200, {
"Content-Type": "text/event-stream",
"Cache-Control": "no-cache",
"Connection": "keep-alive"
});
setInterval(() => res.write(": ping\n\n"), 15000);
第二步,客户端自己兜底重连。在 onerror 里读一下 readyState,等于 CLOSED 就按 3 秒、6 秒、12 秒退避重新 new EventSource,并设置重试次数上限,避免服务端宕机时无限打请求。
第三步,页面隐藏时主动断开。监听 visibilitychange,切到后台就 close,回到前台再建连,避免长时间挂着的连接被中间设备静默回收,也省掉一部分服务端连接数。
验证
重启一次服务端进程,观察 Network 面板里 EventSource 请求是否重新出现,消息面板能否继续追加;再用手机锁屏 5 分钟回来测试,确认连接已经恢复且没有重复消息。
小结
SSE 不重连多半是 204 或者状态码不合法导致浏览器主动放弃。服务端保证 200 加正确 MIME,客户端补退避重连,后台时断开,这套组合在弱网下最稳。
