使用 Django 和 OpenAI API 实现 SSE 流式传输：实用指南

在 AI 驱动的应用世界中，流畅体验与静态体验之间的差异往往在于数据流式传输的能力。Server-Sent Events (SSE) 是一种协议，允许服务器向客户端发送增量更新，使得我们可以逐词展示语言模型的响应，而无需等待完整生成完毕。在本指南中，我们将探讨如何配置一个 Django 端点，从兼容 OpenAI 的 API 流式传输响应。

什么是 SSE 流式传输以及为何使用它

SSE 流式传输利用持久 HTTP 连接将文本事件从服务器发送到浏览器，使用简单的基于换行符分隔的文本行格式。与 WebSocket 不同，SSE 是单向的（服务器到客户端），这使其非常适合文本补全等场景，其中客户端发送请求并接收连续的块流。

优势显而易见：第一个 token 在几毫秒内出现，用户可以看到文本实时显示，连接管理复杂度极低。对于聊天机器人或 AI 助手应用，这种即时感是区分受欢迎产品与令人沮丧产品的关键。

Django 端点配置

要在 Django 中启用流式传输，我们需要用一个 Python 生成器来响应，逐步发送块。关键在于使用 StreamingHttpResponse，设置 Content-Type: text/event-stream 头，并禁用缓存和 HTTP 缓冲。以下是端点的基本结构：

• 定义一个视图，接收请求并将提示词转发给 AI 服务
• 遍历响应流，将每个块封装为 SSE 格式
• 返回带有正确头的 StreamingHttpResponse

处理超时和网络错误至关重要，因为中断的 SSE 连接不会像 WebSocket 那样自动重建。良好的模式是使用 try-except，在发生故障时向客户端发送 error 事件。

与 OpenAI 兼容 API 的集成

大多数现代 AI 提供商——OpenAI、Anthropic、Azure OpenAI，以及 Ollama 或 vLLM 等自托管方案——都支持在补全请求中使用 stream=True 参数。在 Django 中，我们可以依赖 openai 库或 httpx 进行流式传输调用，也可以使用带有 stream=True 的 requests 逐行读取流。

从提供商接收的每个块通常包含一个带有部分文本的 delta 字段。我们的 Django 生成器需要将每个块转换为标准 SSE 格式：一行包含文本的 data: 行，后跟一个空行以定界事件。这种方法确保了与使用原生 EventSource 对象的 JavaScript 客户端的最大兼容性。

前端和事件处理

在客户端侧，只需初始化一个新的 EventSource 实例并指向我们的 Django 端点即可。每当服务器发送 data 事件时，onmessage 回调就会被触发，我们可以将新 token 追加到显示的文本中来更新 DOM。为了提升体验，建议同时处理加载状态，并在生成期间显示闪烁的光标。

一个重要提示是处理自动重连：EventSource 会在错误后尝试重新连接，但在单次聊天请求的上下文中，这种行为可能会造成混淆。在服务器端设置超时，并在生成结束时干净地关闭连接，可以避免孤儿连接问题。

结论

使用 Django 和兼容 OpenAI 的 API 实现 SSE 流式传输是一项立即在用户体验方面获得回报的投资。该模式简单，但需要注意细节：正确的事件格式化、错误处理以及连接的有序关闭。实用的要点是：从读取提供商流中的块并将其作为 SSE 事件转发的 Python 生成器开始，然后添加错误处理程序和超时机制。有了这个基础，您将拥有一个响应式聊天协议，可以集成到任何现代 Web 界面中。