罗罗编程学习记录
本页内容 展开查看

03.14.1 流式响应渲染

所属:全栈开发面试题库 / 03 前端基础与 Web 开发 / 03.14 前端 AI 集成

覆盖范围

  • SSE:EventSource、headers、断线重连
  • Fetch ReadableStream:POST 流式、自定义解析
  • 打字机效果:逐字渲染、Markdown 流式解析
  • 中断与重试:AbortController、错误恢复

高频题速览

编号 题目 难度 频率
03.14.1-001 SSE 与 Fetch Stream 如何实现流式渲染 进阶 ★★★★
03.14.1-002 SSE 与 WebSocket 区别 基础 ★★★★
03.14.1-003 如何中断流式请求 进阶 ★★★
03.14.1-004 流式 Markdown 如何解析 进阶 ★★★
03.14.1-005 SSE 为什么只支持 GET 进阶 ★★★
03.14.1-006 打字机效果如何避免每字重渲染 进阶 ★★★
03.14.1-007 流式请求错误如何处理 进阶 ★★★
03.14.1-008 Fetch Stream 如何解析分块 进阶 ★★★

03.14.1-001 SSE 与 Fetch Stream 如何实现流式渲染

一句话结论

SSE 用 EventSource 自动解析 text/event-stream;Fetch Stream 用 fetch(...).body.getReader() 手动读取分块,支持 POST 请求与自定义解析。

概念解释

  • SSE:服务端推送,文本协议。
  • Fetch Stream:通用 ReadableStream。

原理流程

  1. 服务端返回 Content-Type: text/event-stream。
  2. 客户端逐块读取。
  3. 解析 chunk 追加到 UI。

代码 / 示例

// SSE
const es = new EventSource("/api/stream");
es.onmessage = (e) => appendMessage(e.data);

// Fetch Stream
const res = await fetch("/api/chat", {
  method: "POST",
  body: JSON.stringify({ prompt: "hi" }),
});
const reader = res.body.getReader();
const decoder = new TextDecoder();
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  appendChunk(decoder.decode(value, { stream: true }));
}

常见误区

  • 误区:SSE 不能 POST;正解:EventSource 只支持 GET,POST 流式用 Fetch Stream。
  • 误区:ReadableStream 自动按行解析;正解:需要自己处理 buffer 边界。

追问

  • Q:OpenAI 接口用什么? A:SSE(text/event-stream),前端用 Fetch Stream 解析。
  • Q:如何解析 SSE 格式? A:按 data: 行解析,空行分隔事件。

03.14.1-002 SSE 与 WebSocket 区别

一句话结论

SSE 是单向(服务端到客户端)、基于 HTTP、自动重连、文本;WebSocket 是全双工、独立协议、二进制。

概念解释

  • SSE:单向推送。
  • WebSocket:双向通信。

原理流程

  1. SSE 建立 HTTP 长连接。
  2. WebSocket 握手升级协议。

代码 / 示例

// SSE 适合 AI 流式输出
// WebSocket 适合聊天室、实时协作

常见误区

  • 误区:SSE 不能双向;正解:客户端通过普通 POST 发请求,SSE 只接收流式响应。
  • 误区:WebSocket 一定更好;正解:SSE 更简单,自动重连,HTTP 兼容好。

追问

  • Q:SSE 最大连接数? A:浏览器同源 6 个(HTTP/1.1),HTTP/2 无限制。
  • Q:SSE 支持自定义事件? A:event: 字段指定事件名。

03.14.1-003 如何中断流式请求

一句话结论

用 AbortController,调用 abort() 中断 fetch;SSE 用 es.close()。中断后 UI 保留已生成内容。

概念解释

  • AbortController:现代浏览器通用中断。
  • close:SSE 关闭。

原理流程

  1. 创建 controller。
  2. fetch 传 signal。
  3. 用户点击停止时 abort。

代码 / 示例

const controller = new AbortController();
fetch("/api/stream", { signal: controller.signal });
// 用户点击停止
controller.abort();

常见误区

  • 误区:中断后服务端停止生成;正解:前端断开,服务端可能继续生成直到超时。
  • 误区:SSE 不能中断;正解:es.close() 关闭连接。

追问

  • Q:如何通知服务端停止? A:断开连接后服务端检测到 EOF 自动停止,或发专用 cancel 请求。
  • Q:abort 后如何恢复? A:重新发起请求,从上次位置继续(如果服务端支持)。

03.14.1-004 流式 Markdown 如何解析

一句话结论

流式 Markdown 增量解析:维护 buffer,累积到完整块(段落/代码块)再渲染,避免半行闪烁;用 markdown-it 或 unified。

概念解释

  • buffer:未完整的 chunk。
  • 块级:代码块、列表、标题完整后渲染。

原理流程

  1. 累积 chunk 到 buffer。
  2. 检测完整块(``` 闭合、空行)。
  3. 渲染已完整块,保留未完整块。

代码 / 示例

let buffer = "";
function onChunk(chunk) {
  buffer += chunk;
  const parts = buffer.split("```");
  // 偶数索引是普通文本,奇数是代码块
  renderParts(parts);
  buffer = lastIncompletePart;
}

常见误区

  • 误区:每个 chunk 都渲染 Markdown;正解:半行 Markdown 会闪烁与格式错误。
  • 误区:代码块未闭合也渲染;正解:等待 ``` 闭合再渲染。

追问

  • Q:如何高亮代码? A:流式中先渲染纯文本,代码块闭合后用 highlight.js 高亮。
  • Q:如何避免重渲染? A:只渲染新增部分,已渲染部分用 key 复用。

03.14.1-005 SSE 为什么只支持 GET

一句话结论

EventSource 规范设计为 GET,因为浏览器实现简单、自动重连、可跨域;POST 流式需用 Fetch Stream。

概念解释

  • EventSource:GET only。
  • Fetch Stream:任意方法。

原理流程

  1. EventSource 构造器只接受 URL。
  2. 不能设置 headers。

代码 / 示例

// 不能带 Authorization header
const es = new EventSource("/api/stream");

常见误区

  • 误区:SSE 可以带 header;正解:EventSource 不支持,鉴权用 cookie 或 URL token。
  • 误区:POST SSE 不存在;正解:用 Fetch Stream 读取 SSE 格式。

追问

  • Q:如何带鉴权? A:cookie 自动带,或 URL 加 token。
  • Q:跨域 SSE? A:服务端配置 CORS,EventSource 支持 withCredentials。

03.14.1-006 打字机效果如何避免每字重渲染

一句话结论

React 中每字 setState 会导致整树重渲染;用 requestAnimationFrame 节流,或直接操作 DOM textContent,或用消息块 memo 隔离。

概念解释

  • 节流:rAF 合并多次更新。
  • 直接 DOM:绕过 React。

原理流程

  1. chunk 到达时更新 state。
  2. rAF 内批量更新。

代码 / 示例

let pending = "";
let rafId = null;
function onChunk(chunk) {
  pending += chunk;
  if (rafId) return;
  rafId = requestAnimationFrame(() => {
    setContent((prev) => prev + pending);
    pending = "";
    rafId = null;
  });
}

常见误区

  • 误区:每字 setState 性能好;正解:React 18 自动批处理,但长内容仍会卡。
  • 误区:用 CSS 打字机;正解:CSS 打字机不能逐字追加内容,只能装饰。

追问

  • Q:如何自动滚动到底部? A:scrollTop = scrollHeight,但用户上滚时不自动滚。
  • Q:如何用 ContentEditable 渲染? A:复杂,建议用 dangerouslySetInnerHTML。

03.14.1-007 流式请求错误如何处理

一句话结论

流式错误分两种:HTTP 错误(fetch 抛错)与流式中途错误(服务端返回 error 事件);分别 catch 并显示已生成内容。

概念解释

  • HTTP 错误:非 2xx。
  • 流式错误:200 但中途 error。

原理流程

  1. fetch catch HTTP 错误。
  2. 流式解析时检测 error 字段。
  3. 已生成内容保留,错误提示。

代码 / 示例

try {
  const res = await fetch(...);
  if (!res.ok) throw new Error(res.statusText);
  // 流式读取
} catch (e) {
  showError("生成失败", partialContent);
}

常见误区

  • 误区:流式中服务端报错前端感知不到;正解:200 状态码但 chunk 中包含 error,需要解析。
  • 误区:错误时清空已生成内容;正解:保留已生成内容,标记错误。

追问

  • Q:如何重试? A:重新发起请求,带上次已生成内容作为上下文。
  • Q:网络断开如何检测? A:fetch 抛 TypeError,或心跳超时。

03.14.1-008 Fetch Stream 如何解析分块

一句话结论

Fetch Stream 的 chunk 不一定按行或按 JSON 边界到达,需要维护 buffer,按分隔符(如 \n\n)切分完整事件。

概念解释

  • buffer:累积未完整数据。
  • 分隔符:SSE 用 \n\n。

原理流程

  1. reader.read() 得到 chunk。
  2. 追加到 buffer。
  3. 按分隔符切分完整事件。
  4. 保留最后未完整部分。

代码 / 示例

let buffer = "";
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const events = buffer.split("\n\n");
  buffer = events.pop();
  events.forEach((e) => parseEvent(e));
}

常见误区

  • 误区:每个 chunk 是完整事件;正解:chunk 是网络层分块,可能跨事件。
  • 误区:decoder.decode 不传 stream;正解:stream: true 处理多字节字符跨 chunk。

追问

  • Q:如何处理 UTF-8 跨 chunk? A:TextDecoder 用 stream 模式。
  • Q:SSE 格式中 data: 多行? A:多个 data: 行拼接为一个事件。

待整理清单

  • [ ] 流式请求心跳与超时
  • [ ] 多轮对话上下文管理
  • [ ] 流式输出中的 Function Calling 解析

关联与延伸

  • 与 03.14.2 对话式 UI 配合,流式渲染是对话体验的基础。
  • SSE 与 Fetch Stream 选型取决于请求方法(GET vs POST)。
  • 流式 Markdown 解析是 AI 前端的核心难点,需处理代码块边界。