Python 流式响应
原创

Python

Python 流式响应

发表于 2026-11-21

更新于 4小时前

阅读量: 3

学习笔记说明

这是一篇Python的学习笔记,关于Python 流式响应,仅做记录

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: 连接终止
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

关键特征:

  • 基于标准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: 连接优雅关闭
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

关键特征:

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

Fast API 结合

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

SSE vs WebSocket 对比

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