第 2 章:浏览器怎么收流
三种接收方式里,只有一种能同时满足"POST、带鉴权头、随时取消"。选错它,后面每一步都在打补丁。
学习目标
- 说清轮询、EventSource、
fetch流各自的边界 - 知道 EventSource 为什么不能用于对话场景
- 会用
fetch+ReadableStream接一段流,并用 AbortController 取消 - 处理多字节字符被切断的问题
2.1 三种接收方式
| 方式 | 怎么工作 | 延迟 | 能否 POST / 带 header |
|---|---|---|---|
| 轮询 | 每 2 秒问一次"好了没" | 差(取决于间隔) | 可以 |
| EventSource | 浏览器内置,自动重连 | 好 | 不能 |
fetch + 流 | 自己读 response.body | 最好 | 可以 |
2.2 EventSource 的三条硬限制
js
const es = new EventSource("/api/stream"); // 只能这样- 只能 GET:对话要把整个消息数组发过去,放 query 里既不安全也有长度上限;
- 不能带自定义头:
Authorization、X-Tenant-Id都加不了(有些浏览器支持withCredentials,但只解决 Cookie); - 重连策略不可控:它按服务端
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.ok | 401/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] 怎么认。