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

第 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 错误分类 ​

同一句"出错了",处理方式差很多请求失败401 / 403鉴权失效→ 重新登录429限流→ 退避后重试5xx服务端异常→ 有限重试网络断离线→ 等恢复可自动重试429(带 Retry-After)、5xx(非 501)、网络抖动用指数退避:1s → 2s → 4s,最多 3 次不要自动重试401(重试也没用,要重新登录)400 参数错误、内容审核拒绝流内错误(协议层没坏,但生成中断)模型侧 content_filter / 上下文超长 / 工具参数非法:这几种要在回答里说明,而不是弹"网络错误"全部错误共用一个提示,用户只会做一件事:刷新。分类是让人能做对下一步动作的前提。原则:能自动恢复的别让用户点,需要用户决策的别偷偷重试。

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 续写,语义不同
断网监听在线状态 + 幂等键
界面原因、保留说明、下一步、手动入口

下一章 ​

最后一章:把这套东西真正上线——性能、可访问性、移动端,以及让用户看见成本。

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