HTTP Server-Sent Events (SSE) 协议的基础格式

以下是 HTTP Server-Sent Events (SSE) 协议的基础格式详解：

---

一、协议基础

SSE 是 HTML5 规范中定义的服务器到客户端的**单向通信协议**，特点：
- 基于 HTTP 长连接（`Content-Type: text/event-stream`）
- 使用纯文本格式传输数据
- 默认支持断线重连
- 浏览器原生支持（通过 `EventSource` API）

---

二、核心消息格式

每条消息由 **字段行** 和 **空行终止符** 组成：

```text
[field]: [value]\n
[field]: [value]\n
\n
```

#### **1. 必需字段**
- **`data` 字段**  
  定义消息内容，可多行传输：
  ```text
  data: { "status": "success" }\n
  data: Continued on next line\n
  \n
  ```
  客户端接收时会合并为完整数据：`{ "status": "success" }\nContinued on next line`

#### **2. 可选字段**
- **`event` 字段**  
  定义事件类型（默认类型为 `message`）：
  ```text
  event: status_update\n
  data: 系统已启动\n
  \n
  ```

- **`id` 字段**  
  设置消息ID（用于断线重连时定位）：
  ```text
  id: 42\n
  data: 当前温度：23℃\n
  \n
  ```

- **`retry` 字段**  
  指定重连时间（毫秒）：
  ```text
  retry: 3000\n
  \n
  ```

---

三、技术规范要点

1. **编码要求**  
   - 必须使用 UTF-8 编码
   - 换行符统一为 `\n`（Unix风格）

2. **消息终止**  
   每个消息块必须由两个连续的换行符 `\n\n` 结束

3. **BOM处理**  
   禁止在数据流开头添加字节顺序标记（BOM）

4. **MIME类型**  
   响应头必须包含：
   ```http
   Content-Type: text/event-stream
   Cache-Control: no-cache
   Connection: keep-alive
   ```

---

四、完整示例

#### 服务器响应示例：
```text
HTTP/1.1 200 OK
Content-Type: text/event-stream
Transfer-Encoding: chunked

event: alert
data: {"level": "critical", "msg": "CPU过载"}

id: 101
data: 当前用户数：256
data: 在线设备数：89

retry: 10000

```

#### 客户端处理（JavaScript）：
```javascript
const eventSource = new EventSource('/stream');

eventSource.addEventListener('alert', (e) => {
  console.log(JSON.parse(e.data)); 
});

eventSource.onmessage = (e) => {
  console.log('未命名事件:', e.data);
};
```

---

五、特殊场景处理
1. **多行数据**  
   通过重复 `data:` 行实现：
   ```text
   data: {\n
   data:   "id": 123,\n
   data:   "name": "示例"\n
   data: }\n
   \n
   ```

2. **注释行**  
   以 `:` 开头的行会被忽略：
   ```text
   : 这是心跳检测时间戳 1630000000\n
   data: ping\n
   \n
   ```

3. **错误恢复**  
   当连接中断时，浏览器会自动尝试重连（遵循 `retry` 设定）

---

六、协议对比

| 特性               | SSE             | WebSocket         |
|--------------------|-----------------|-------------------|
| 通信方向           | 单向（服务端→客户端） | 双向              |
| 协议基础           | HTTP            | 独立协议 (ws/wss) |
| 数据格式           | 文本            | 二进制/文本       |
| 自动重连           | ✅              | ❌                |
| CORS处理           | 需要配置        | 需要配置          |

---

通过这种规范化的消息格式，SSE 实现了高效的服务器推送能力，适用于股票行情、实时日志、进度通知等场景。

---DEEPSEEK