1 / 4概念
Realtime WebSocket and SSE
这一页判定“用什么形状把服务端的新数据送到客户端”,以及为什么长连接总在整分钟处断开。读完应能为一条推送链路选对协议,并配好心跳、重连、背压与代理超时。
1 概念
1.1 一句话定义
WebSocket 是在一次 HTTP Upgrade 之后保持的全双工帧通道;SSE 是普通 HTTP 响应上的单向文本事件流;长轮询则用重复请求模拟推送。
1.2 它解决什么问题
- 降低推送延迟:不必等客户端下一次轮询,新数据可以立即下发。
- 省掉空轮询:轮询在无数据时仍然消耗请求与连接,长连接只在有数据时传输。
- 穿透既有基础设施:SSE 走标准 HTTP,WebSocket 只需代理支持 Upgrade。
- 支撑协作与行情场景:低延迟双向交互、多人同步、实时通知都要持续通道。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| HTTP 方法与状态码语义 | HTTP |
| gRPC 的四种流式模式 | RPC and gRPC |
| 事件驱动与消息中间件 | Event-Driven Architecture |
| 代理、负载均衡与超时配置 | Load Balancing |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 101 | 协议切换成功的状态码 | 不是 200 的变体 |
| opcode | 帧头里的操作码,决定帧类型 | 不是消息类型,业务类型在负载里 |
| 掩码 | 客户端到服务端帧必须做的异或 | 服务端帧不得掩码 |
| 事件流 | text/event-stream 响应体 | 不是 chunked 的别名 |
| Last-Event-ID | SSE 断线续传的请求头 | 不是查询参数 |
| 心跳 | 定期 ping/pong 或注释行 | 不是业务消息 |
| 背压 | 消费慢时限制生产速度 | 不是限流,也不等于丢消息 |
2 机制
2.1 心智模型
三种形状的差别在方向与连接寿命:SSE 是一条只读的长响应,WebSocket 是一条可读可写的长连接,长轮询是不断重建的短请求。可靠性不来自连接,而来自消息层的序号与重放。
| 方案 | 方向 | 连接寿命 | 典型场景 |
|---|---|---|---|
| SSE | 服务端到客户端 | 长,自动重连 | 通知、进度、日志 |
| WebSocket | 双向 | 长,需自建重连 | 协作、行情、游戏 |
| 长轮询 | 服务端到客户端 | 短,反复重建 | 兼容性兜底 |
2.2 机制拆解
- 握手:客户端发 GET 加 Upgrade、Connection、Sec-WebSocket-Key 与版本 13;服务端回 101 与 Sec-WebSocket-Accept,值为 key 拼接固定 GUID 后取 SHA-1 再 base64。
- 帧结构:FIN、RSV、opcode、MASK、长度与掩码键组成帧头,开销 2 至 14 字节;消息可跨帧分片,首帧 opcode 非 0,后续为 continuation。
- SSE 格式:响应体按行解析,data 累积为消息,event 指定类型,id 设置游标,retry 指定重连间隔,冒号开头为注释,空行分隔事件。
- 重连:EventSource 自动重连并带 Last-Event-ID;WebSocket 需要自己实现指数退避加抖动,并在恢复后拉快照补差量。
- 背压:发送缓冲有上限,消费端慢时应暂停读取或丢弃旧值,而不是让队列无界增长。
2.3 完整枚举
opcode 只有 4 位,下表穷举全部取值:0x3 至 0x7 与 0xB 至 0xF 为保留位,未协商扩展时必须断开连接。
| opcode | 名称 | 方向 | 用途 |
|---|---|---|---|
| 0x0 | continuation | 双向 | 分片消息的后续帧 |
| 0x1 | text | 双向 | UTF-8 文本负载 |
| 0x2 | binary | 双向 | 二进制负载 |
| 0x3–0x7 | 保留(非控制) | 不适用 | 留给扩展,未协商即断开 |
| 0x8 | close | 双向 | 关闭握手,带关闭码与原因 |
| 0x9 | ping | 双向 | 心跳探测,必须回 pong |
| 0xA | pong | 双向 | 心跳应答或主动保活 |
| 0xB–0xF | 保留(控制) | 不适用 | 留给扩展,未协商即断开 |
关闭码按区间分类,区间决定该重连还是该报错。
| 区间 | 含义 | 例子 | 处理 |
|---|---|---|---|
| 1000–1015 | 标准码与保留码 | 1000 正常、1001 离开、1006 异常 | 1006 与 1015 只能本地生成,不可发送 |
| 2000–2999 | 协议扩展保留 | 不应被应用使用 | 忽略 |
| 3000–3999 | 应用注册码 | 需在注册表登记 | 按注册语义分支 |
| 4000–4999 | 私有应用码 | 自定义重连或降级 | 在文档中固定含义 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 帧头开销 | 2–14 字节 | 取决于负载长度与是否掩码 |
| 默认心跳间隔 | 20–60 s | 必须小于链路最短 idle timeout |
| 代理 idle timeout | 60 s 常见 | ALB 与 nginx 默认值 |
| 重连退避 | 1–30 s 加抖动 | 避免断线后同时重连 |
| 单节点连接数 | 1 万–10 万 | 受内存与文件描述符限制 |
3 实践
3.1 最小示例
手工完成握手,观察 101 与 Accept 值;再用 curl 订阅 SSE 并演示断点续传。
# WebSocket 握手:101 与 Sec-WebSocket-Accept 必须匹配
curl -i -N -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
-H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
https://example.com/feed
# SSE:-N 关闭缓冲;断线后带 Last-Event-ID 续传
curl -N -H 'Accept: text/event-stream' https://example.com/events
curl -N -H 'Last-Event-ID: 1024' https://example.com/events
事件流的关键在于分隔与游标,代理若缓冲或压缩就会让消息“攒着到”。
HTTP/1.1 200 OK
Content-Type: text/event-stream
Cache-Control: no-cache, no-transform
Connection: keep-alive
id: 1024
event: price
data: {"symbol":"BTC","px":61234}
retry: 3000
: heartbeat
3.2 常用操作与参数
| 操作 | 命令 / 工具 | 说明 |
|---|---|---|
| 手工握手 | curl -i -N 带 Upgrade 头 | 看 101 与 Accept 值 |
| WebSocket 客户端 | websocat wss://host/feed | 收发帧、观察关闭码 |
| 订阅 SSE | curl -N -H 'Accept: text/event-stream' | 关缓冲才能看到流式输出 |
| 看帧与负载 | DevTools 的 WS 面板 | 显示 opcode 与消息体 |
3.3 标准流程
- 定方向与寿命:只需服务端推送用 SSE,需要双向交互用 WebSocket,不要用轮询硬撑实时。
- 定接入:SSE 天然过代理;WebSocket 先确认 LB 与 CDN 支持 Upgrade 且不缓冲。
- 定心跳:间隔小于链路最短 idle timeout,优先服务端 ping,辅以应用层心跳。
- 定重连:指数退避加抖动,SSE 用 Last-Event-ID 续传,WebSocket 用快照加增量恢复。
- 定背压:发送缓冲设上限,超限降级为采样或断开,避免内存无界增长。
- 定观测与降级:记录连接数、关闭码与重连率,保留轮询作为兜底方案。
3.4 与相邻技术的组合
- 负载均衡:必须支持 Upgrade 与更长的 idle timeout,且不能缓冲响应。
- CDN:SSE 不能被缓存或改写,需 no-cache 与 no-transform;WebSocket 通常绕过缓存层。
- 认证:握手时带 Cookie 或 token,服务端必须校验 Origin,CORS 不能替代来源校验。
- 事件驱动:推送只负责传输,顺序、去重与重放由消息中间件承担。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 方向 | 单向 / 双向 | 单向选 SSE,双向选 WebSocket |
| 客户端 | 浏览器 / 原生 / 服务端 | EventSource 不支持自定义头 |
| 代理与 CDN | 友好 / 受限 | 无法 Upgrade 时只能 SSE 或轮询 |
| 消息频率 | 低频 / 高频 | 高频要评估背压与扇出成本 |
| 可靠性要求 | 可丢 / 必达 | 必达需要序号、确认与重放 |
3.6 决策规则
- 服务端单向通知:选 SSE,自动重连且走普通 HTTP。
- 双向交互、低延迟:选 WebSocket。
- 只需最终状态、可容忍秒级延迟:长轮询最简单。
- 大量只读订阅:SSE 加广播层,避免每连接一个线程。
- 需要严格顺序与重放:在消息层加序号与去重,不要依赖连接本身。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| WebSocket | 全双工、帧开销小 | 需自建重连、心跳与背压 | 协作、行情、游戏 |
| SSE | 简单、自动重连、走 HTTP | 单向、文本为主 | 通知、进度、日志 |
| 长轮询 | 兼容性最好 | 延迟高、请求开销大 | 老旧客户端兜底 |
| gRPC streaming | 强类型、双向、复用 h2 | 浏览器需代理 | 内部服务推送 |
3.8 何时不该用
- 普通 CRUD:用 HTTP 请求/响应,不要为每次操作建长连接。
- 只需一次性结果:同步 HTTP 更简单,长连接反而增加故障面。
- 客户端在严格代理后且不能 Upgrade:改用 SSE 或轮询。
- 消息必须强事务:推送层不保证投递,交给消息队列与消费确认。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 连接每 60 s 断开一次 | 代理 idle timeout | 心跳短于 timeout,或调大超时 |
| 关闭码 1006 频繁 | 网络切换、进程被杀或链路中断 | 加心跳与重连,恢复后拉快照 |
| SSE 事件延迟到达 | 中间层缓冲或压缩 | 关闭压缩,加 no-transform 并 flush |
| 内存持续上涨 | 无背压,发送队列堆积 | 设缓冲上限与丢弃策略 |
| 握手返回 403 | Origin 校验失败 | 校正白名单,不要只放开 CORS |
| 断线后消息丢失 | 没有 Last-Event-ID 或序号 | 用 id 续传并在客户端去重 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 用 WebSocket 做 CRUD | 重写请求/响应与错误处理 | HTTP 加 JSON |
| 长连接不做心跳 | 静默断连,客户端无感知 | ping/pong 加应用层心跳 |
| 发送队列无上限 | 内存暴涨、延迟失控 | 背压与上限 |
| 每连接一个线程 | 连接数上不去 | 事件循环与异步 IO |
4.3 可观测信号
在线连接数与新建/断开速率;关闭码分布,尤其是 1006 与 1009;心跳 RTT 与超时次数;重连率与重连耗时;每连接发送缓冲大小;SSE 的首字节与事件间隔;扇出时单条消息的投递耗时。
4.4 安全 / 性能 / 一致性边界
- 安全:HTTPS 页面只能连 wss;握手必须校验 Origin 与 token,不能只靠 CORS;限制单连接消息大小与频率以防滥用。
- 性能:长连接占用文件描述符与内存,扩容按连接数而非 QPS;扇出成本随订阅数线性增长,需要广播层。
- 一致性:WebSocket 保证单连接内有序,不保证跨重连不丢;SSE 的 id 只是游标,服务端必须能按游标重放。
- 降级:任何长连接方案都要有轮询或短连接兜底,否则代理升级当天就会全站失联。