Skip to content
Lv5AI 对话前端进度 2 / 10

第 2 章:浏览器怎么收流 ​

三种接收方式里,只有一种能同时满足"POST、带鉴权头、随时取消"。选错它,后面每一步都在打补丁。


学习目标 ​

  • 说清轮询、EventSource、fetch 流各自的边界
  • 知道 EventSource 为什么不能用于对话场景
  • 会用 fetch + ReadableStream 接一段流,并用 AbortController 取消
  • 处理多字节字符被切断的问题

2.1 三种接收方式 ​

方式怎么工作延迟能否 POST / 带 header
轮询每 2 秒问一次"好了没"差(取决于间隔)可以
EventSource浏览器内置,自动重连好不能
fetch + 流自己读 response.body最好可以
同样是"等回答",三种方式的代价完全不同轮询:N 次请求每 2 秒一次,多数是空响应延迟 = 间隔的一半,服务端压力大EventSource:GET 直达浏览器内置,断线自动重连只能 GET、不能加 Authorizationfetch + 流:自己读POST + header + 随时 abort要自己解析帧,但完全可控对话产品的三个硬需求:发送多条消息(POST)、带登录态(Authorization)、用户能停(abort)。只有第三种全部满足。所以本课主线用 fetch 流,EventSource 只在第 10 章做对照。EventSource 仍然有用:公开的进度推送、无需鉴权的通知流,它比自己写重连省事。

2.2 EventSource 的三条硬限制 ​

js
const es = new EventSource("/api/stream");   // 只能这样
  1. 只能 GET:对话要把整个消息数组发过去,放 query 里既不安全也有长度上限;
  2. 不能带自定义头:Authorization、X-Tenant-Id 都加不了(有些浏览器支持 withCredentials,但只解决 Cookie);
  3. 重连策略不可控:它按服务端 retry: 指令自动重连,你无法在"用户点了停止"时干净地终止语义。

第三条最麻烦:es.close() 能断开,但已经收到的内容与"服务端是否继续生成"之间的状态对不上。


2.3 fetch + ReadableStream 怎么接 ​

ts
const ctrl = new AbortController();

const resp = await fetch("/api/chat", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ messages }),
  signal: ctrl.signal,              // 取消用这个
});

if (!resp.ok || !resp.body) throw new Error(`HTTP ${resp.status}`);

const reader = resp.body.getReader();
const decoder = new TextDecoder();
let buffer = "";

while (true) {
  const { done, value } = await reader.read();
  if (done) break;

  buffer += decoder.decode(value, { stream: true });   // 注意 stream: true
  // 交给第 3 章的分帧逻辑处理 buffer
}

四个细节,少一个就会出问题:

细节不做的后果
signal: ctrl.signal停止按钮无效,请求还在跑
decoder.decode(value, { stream: true })中文被切成乱码(多字节字符跨 chunk)
自己维护 buffer帧被切成两半,解析失败
检查 resp.ok401/429 时把错误页当流解析

为什么中文会乱:UTF-8 一个汉字占 3 字节,网络分片可能正好切在中间。TextDecoder 加 stream: true 会把不完整的字节留在内部,等下一片拼上再输出。


2.4 取消:两种"停" ​

ts
// 用户点停止
ctrl.abort();

// 超时兜底:比如 60 秒没有任何片段就放弃
const timeout = setTimeout(() => ctrl.abort(), 60_000);
// 收到第一个片段后要清掉,别把"总时长"当成"无响应时长"

abort() 之后 reader.read() 会抛 AbortError,必须 try/catch 并识别它,否则会被当成真实错误显示"出错了"。

ts
try {
  while (true) { /* … */ }
} catch (e) {
  if (e.name === "AbortError") return markAborted();   // 用户主动停,不是故障
  throw e;
}

2.5 一次流式接收的时序 ​


2.6 选型的三个判断 ​

你的情况选什么
对话、需要 POST + 鉴权 + 可停fetch + 流
服务端主动推通知、无需鉴权EventSource
兼容极旧浏览器、无法用流轮询 + 长任务接口

还有一条经验:不要同时维护两套。见过项目里 EventSource 与 fetch 流各写一遍,最后两边状态不一致,排查花了三天。


本章小结 ​

要点说明
三种方式轮询、EventSource、fetch 流
EventSource 限制只能 GET、不能带自定义头、重连不可控
fetch 四细节signal、stream:true、buffer、检查 ok
中文乱码多字节字符跨 chunk,用 stream:true 解码
取消abort 会抛 AbortError,要单独识别
选型对话场景一律 fetch 流

下一章 ​

拿到 chunk 只是"原始字节"。下一章讲 SSE 帧怎么切、半帧怎么拼、[DONE] 怎么认。

本文阅读--次|全站访问--次|访客--人