HTML5SSE断连问题解决方法

HTML5 SSE（Server-Sent Events）在实际应用中常陷入“看似正常却收不到数据”或“断连后静默卡死”的困境——根本原因往往不是代码逻辑错误，而是服务端响应头缺失`Content-Type: text/event-stream`、消息格式不规范（如前置空行或末尾仅单换行）、重连机制被默认策略误导、跨域配置不严谨，或页面生命周期管理疏忽导致连接堆积与内存泄漏；真正可靠的解决方案在于严格校验服务端输出、主动监听并判断`readyState`状态、手动关闭与重建实例、实现指数退避重连，并在跨域场景下精准配置`withCredentials`与服务端CORS响应头，唯有系统性地把控这五个关键环节，才能让SSE稳定、可控、长时运行。

EventSource 连接失败时浏览器不报错但收不到数据

这是最常见的情况：页面看似正常执行了 new EventSource()，控制台没报错，但 onmessage 从不触发。根本原因通常是服务端响应头缺失或错误。

• 必须返回 Content-Type: text/event-stream，少一个字母或带 charset 都可能被部分浏览器（如 Safari）静默拒绝
• 响应体开头不能有空行、BOM 或任意前置输出（PHP 的 echo "\n";、Node.js 的 res.write("\n") 都会中断流）
• 每条消息末尾必须是两个换行符 \n\n，单个 \n 会导致解析卡住
• Chrome DevTools 的 Network 面板里，SSE 请求状态码为 200 但预览为空，基本可断定是响应头或格式问题

重连机制没生效，断网后连接永远挂起

EventSource 自带重连，但默认行为很“懒”：断连后等 3 秒再试，且不区分网络不可达、服务宕机还是超时。实际项目中必须手动接管。

• 监听 onerror 时不要只看事件对象——它在连接建立前、建立中、已建立后都可能触发，无法区分具体阶段；应结合 readyState 判断：readyState === 0 表示未连接或连接失败，=== 2 才是已连接
• 主动调用 eventSource.close() 后，必须重新 new EventSource()，仅靠原实例不会自动恢复
• 建议用指数退避：首次重试 1s，失败则 2s、4s、8s…上限设为 30s，避免雪崩式请求
• 服务端若返回 retry: 5000，仅影响下一次重连间隔，不影响前端已设置的逻辑

跨域场景下 EventSource 报 CORS 错误

和普通 AJAX 不同，EventSource 只支持 GET，且不发送 Cookie（除非显式配置），但 CORS 检查更严格：服务端必须返回 Access-Control-Allow-Origin，且不能为 *（当携带凭证时）。

• 如果前端需要带 Cookie（比如鉴权 session），初始化时必须加 { withCredentials: true }，否则浏览器直接拒发请求
• 服务端响应头必须同时满足：Access-Control-Allow-Origin: https://your-domain.com（不能是 *）、Access-Control-Allow-Credentials: true
• Nginx 反向代理时，确保 proxy_pass 后端服务返回了正确响应头，而不是被 Nginx 覆盖或过滤掉
• 开发环境用本地 server 代理接口？确认代理规则转发了所有响应头，特别是 Access-Control-Allow-* 系列

长时间运行后内存泄漏或连接堆积

页面未销毁 EventSource 实例就跳转或关闭，是典型泄漏源。现代浏览器虽会回收，但旧版 Chrome 或 Electron 中可能残留连接。

• 组件卸载/页面离开前，务必调用 eventSource.close()，并在调用后将引用置为 null
• 避免全局变量存储 EventSource，尤其在 SPA 中反复进入同一页面时，容易重复创建却未清理旧实例
• 服务端需设置合理的 keep-alive 心跳（如每 15s 发送 :keepalive\n\n），否则 Nginx/Apache 默认 60s 断连，前端会误判为异常断开而频繁重连
• 用 chrome://net-internals/#events 查看底层连接状态，比单纯看 Network 更准——能看到是否真的建立了 HTTP/1.1 流式连接

真正麻烦的不是连不上，而是连上了却收不到数据，或者断连后你以为它在重试，其实早就卡死在 readyState 0 了。检查响应头、验证 readyState、手动控制 close 和重建，这三步绕不开。

到这里，我们也就讲完了《HTML5SSE断连问题解决方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于HTML5的知识点！