第 9 章:中断、重试与错误恢复
正常回答只有一条路径,出错有十条。这一章做的事,是让"出错"也变成一种明确的状态,而不是一个转不完的圈。
学习目标
- 区分"用户停"与"系统错",并让两者在界面上长得不一样
- 按错误码决定"重试、等一会、还是改配置"
- 用超时兜住"卡住不动"这种最难受的故障
- 让重试不丢已有的内容
9.1 用户主动停止
abort() 之后要做三件事:
ts
function onStop(msgId: string) {
ctrl.abort();
updateMessage(msgId, m => ({ ...m, status: "aborted" })); // 1. 状态
// 2. 保留已收到的 parts —— 千万不要清空
// 3. 界面上给"继续生成"入口
}三个常见的错误实现:
| 错误 | 后果 |
|---|---|
| 停止后把消息删除/清空 | 用户白等了几十秒 |
停止后标成 done | 无法续写,也不知道被打断过 |
| 停止后仍在后台写片段 | 内容继续变长,用户以为见鬼了 |
第三点要靠 abortedRef 之类的标记,在 chunk 回调里直接丢弃后续片段。
9.2 超时:两种"卡住"
| 类型 | 判断依据 | 合理阈值 |
|---|---|---|
| 首字超时 | 请求发出后一直没收到第一个片段 | 20–30 秒 |
| 空转超时 | 收到过片段,但两片之间间隔太长 | 30–60 秒 |
| 总时长上限 | 整轮生成太久 | 依据业务,通常 2–5 分钟 |
ts
let firstTimer = setTimeout(() => fail("首字超时"), 25_000);
let idleTimer: number;
function onChunk() {
clearTimeout(firstTimer);
clearTimeout(idleTimer);
idleTimer = setTimeout(() => fail("长时间无响应"), 45_000); // 每次重置
}一定要清掉前一个定时器,否则"总时长"会被误判成"卡住"。
9.3 错误分类
9.4 重试不丢内容
两种重试,语义完全不同:
| 类型 | 做什么 | 用在哪 |
|---|---|---|
| 整轮重试 | 重新发一次完整请求,替换当前消息 | 首个片段之前就失败 |
| 续写 | 把已有内容作为前缀,请求"接着写" | 中途失败、用户主动停 |
ts
// 续写:把已生成内容带上,说明"从这里继续"
const payload = {
messages: [...history, { role: "assistant", content: partialText }],
continue_from: partialText.length,
};续写的坑:模型可能重复上一句。缓解办法是在 prompt 里明确"以下是已生成内容,请从中断处继续,不要重复",并做一次前后缀重叠检测。
9.5 断网与"回到前台"
两个必备:
- 监听
online/offline,离线时把输入框禁用,别让用户点了没反应; - 幂等键:重试时带同一个
request_id,服务端能判断"这是重试还是新问题",避免重复扣费/重复生成。
9.6 错误界面怎么写
一个够用的错误条包含四样:
| 元素 | 例子 |
|---|---|
| 发生了什么 | "模型服务繁忙(429)" |
| 是否保留内容 | "已生成的部分已保留" |
| 下一步 | "10 秒后自动重试" / "重新登录" |
| 手动入口 | 重试按钮、复制错误详情 |
tsx
{msg.status === "error" && (
<div className="err">
<p>{friendly(msg.error)}</p>
{msg.parts.length > 0 && <p>已生成 {countChars(msg)} 字,已保留</p>}
{msg.error?.retryable && <button onClick={() => retry(msg.id)}>重试</button>}
</div>
)}9.7 一张检查表
| 场景 | 该有 | 不该有 |
|---|---|---|
| 用户点停止 | 保留内容 + 可续写 | 清空 / 继续偷偷生成 |
| 首字超时 | 明确"服务无响应" | 一直转圈 |
| 429 | 退避 + 倒计时 | 立刻连续重试 |
| 401 | 引导登录 | 无限重试 |
| 断网 | 禁用输入 + 恢复后自动续 | 弹"未知错误" |
| 内容过滤 | 说明原因 | 伪装成网络错误 |
本章小结
| 要点 | 说明 |
|---|---|
| 停止 | aborted 状态 + 保留内容 + 可续写 |
| 超时 | 首字超时与空转超时分开,记得清定时器 |
| 分类 | 401 不重试、429 退避、5xx 有限重试 |
| 重试 | 整轮重试 vs 续写,语义不同 |
| 断网 | 监听在线状态 + 幂等键 |
| 界面 | 原因、保留说明、下一步、手动入口 |
下一章
最后一章:把这套东西真正上线——性能、可访问性、移动端,以及让用户看见成本。