曦杨

外观

流式响应

约 705 字大约 2 分钟

2026-09-10

SSE模式

sequenceDiagram
    participant C as 客户端
    participant S as 服务端

    C->>S: GET /events (EventSource)
    S-->>C: HTTP 200 + Content-Type: text/event-stream
    Note over C,S: 建立长连接，保持打开状态

    loop 服务端持续推送
        S->>C: data: 消息片段1\n\n
        S->>C: data: 消息片段2\n\n
        S->>C: data: 消息片段3\n\n
        S->>C: event: error\ndata: 消息片段3\n\n
    end

    C->>S: 关闭连接 / 网络断开
    Note over C,S: 连接终止

关键特征：

  • 基于标准HTTP协议
  • 单向通信：仅服务端→客户端推送
  • 数据格式为text/event-stream，每条消息以双换行符(\n\n)结尾
  • 适合新闻推送、股票行情、日志流等场景

Fast API 结合

项信息
中间件请求/响应会经过所有HTTP中间件
后续流式内容不经过中间件
异常处理响应过程中的异常会经过异常处理函数
后续流式内容不经过异常处理函数
依赖注入所有流式内容全部完成后才会迭代完成
token携带原生EventSource只能将token放到query中
自定义或第三方库可以任意方式携带token

WebSocket模式

sequenceDiagram
    participant C as 客户端
    participant S as 服务端

    C->>S: GET /ws<br/>Connection: Upgrade<br/>Upgrade: websocket
    S-->>C: HTTP 101 Switching Protocols<br/>Upgrade: websocket
    Note over C,S: 协议升级完成，WebSocket连接建立

    C->>S: 发送文本/二进制帧
    S->>C: 推送文本/二进制帧
    C->>S: 发送文本/二进制帧
    S->>C: 推送文本/二进制帧
    Note over C,S: 全双工通信，任意一方可随时发送

    C->>S: Close帧 (主动关闭)
    S-->>C: Close确认帧
    Note over C,S: 连接优雅关闭

关键特征：

  • 先通过HTTP握手，再升级为WebSocket独立协议（ws:// 或 wss://）
  • 全双工通信：客户端和服务端均可主动发送消息
  • 数据帧支持文本和二进制格式
  • 适合在线聊天、多人协作、实时游戏等高频双向交互场景

Fast API 结合

项信息
中间件请求/响应都不会经过HTTP中间件
异常处理不会经过异常处理函数
依赖注入连接断开后才会迭代结束
token携带浏览器不支持自定义头，只能通过query携带token

SSE vs WebSocket 对比

特性SSEWebSocket
通信方向服务端→客户端（单向）全双工（双向）
协议基础HTTP独立协议（基于HTTP握手）
自动重连原生支持需手动实现
数据格式文本（text/event-stream）文本或二进制
适用AI场景简单的问答模式Agent 工作流
多人在线的AI协作