交互与用户体验 / 系统课时
处理超时中断与断线恢复
处理超时中断与断线恢复
用户发送消息后,首字迟迟不出现、答案输出到一半断线,或后台已执行却没有返回结果,都不能简单显示“失败”。这里设计一套可落地的识别、提示和恢复规则,让用户保留已有内容,并避免重试造成重复操作。
学习目标
- 区分等待过久、连接中断、服务端失败和执行结果未知。
- 为流式回答与真实任务分别设计恢复入口和重试限制。
- 用明确的测试场景验证去重、续传与错误提示。
按请求阶段识别异常
以一条消息为单位记录 requestId、是否收到服务端确认、最后事件时间、已展示文本和任务执行状态。下表阈值是交互原型的起点,应结合服务端心跳间隔和线上延迟分布调整,不能仅凭计时就断言任务失败。
| 观察到的情况 | 界面反馈 | 可用操作 |
|---|---|---|
| 提交后 8 秒仍无接收确认 | 尚未确认请求是否送达 | 检查状态;暂不重复提交 |
| 已确认接收,超过 8 秒仍无首段正文 | 响应较慢,仍在等待 | 继续等待;停止接收 |
| 输出中连续 10 秒无内容或心跳 | 连接可能中断,正在核验 | 保留已有文本;查看恢复状态 |
| 服务端明确返回限流或失败 | 展示原因与可恢复条件 | 按建议时间重试;必要时反馈问题 |
浏览器显示离线可作为提示,却不能证明服务端未收到请求。网络超时也只表示客户端没有及时获得结果;对于导出、发信等操作,后台可能仍在执行。
画出状态与恢复分支
正常路径为“提交并确认接收 → 等待首字 → 流式输出 → 完成”。等待或输出过程中发生异常,先进入“连接异常”,核验原请求的状态,再决定恢复连接、展示失败,还是等待确认;不要让异常状态直接指向“再次执行”。

流中断时保留已收到的段落,并在末尾标记“回答未完成”,不能将半截内容伪装成完整答案。只有服务端保存了事件及续传位置,才可凭原 requestId 和最后事件序号续接;若不支持续传,应明确提示“无法继续原回答,可重新生成”,且新回答另起一条,避免拼接出重复段落。
控制重试与重复执行
发送按钮在首次提交后立即进入忙碌态,直到原请求明确完成或进入可操作的恢复状态。重连应关联原生成尝试或任务。传输请求 ID 可随连接变化,但业务操作 ID 和同一次提交的幂等键应保持稳定。服务端需实现幂等校验或任务状态查询,仅在前端禁用按钮不足以防止重复执行。
| 请求类型 | 恢复规则 |
|---|---|
| 普通知识问答、无副作用的生成 | 若确认原请求已失败且无法续传,可让用户重新生成;网络型重连最多尝试 2 次,退避 1 秒、2 秒 |
| 导出报表、发邮件、修改数据 | 不自动重放执行请求;先按原请求标识查询任务状态,确定未执行后才允许明确确认的重试 |
| 收到 HTTP 429 | 如返回 Retry-After,按秒数或 HTTP 日期解析。不可解析或缺失时走有限退避 |
| 无法确认执行结果 | 显示“状态尚未确认”,提供查询状态,不显示暗示安全的“一键重试” |
例如用户提交“导出最近 30 天订单”,后台已接受任务但连接断开。界面应显示“正在核实导出状态”;如果查询到任务仍在运行,就继续等待同一任务的结果,而不是再次创建导出任务。用户主动发起全新任务时,才分配新的请求标识。
在续传时拒绝跳过缺失事件
以下约定服务端为每次尝试提供从 1 开始的连续序号。SSE 的原生事件 ID 本身可以是字符串,不保证可做算术。本例的连续序号是业务层另外约定的字段。
function applyDelta(state, event) {
if (event.attemptId !== state.attemptId) return { state, status: "foreign" };
if (!Number.isSafeInteger(event.seq) || event.seq < 1 || typeof event.text !== "string") {
return { state, status: "invalid" };
}
if (event.seq <= state.lastSeq) return { state, status: "duplicate" };
if (event.seq !== state.lastSeq + 1) return { state, status: "gap" };
return {
state: { ...state, lastSeq: event.seq, text: state.text + event.text },
status: "applied"
};
}
let state = { attemptId: "a1", lastSeq: 1, text: "第一段" };
for (const [seq, text] of [[1, "重复"], [3, "第三段"], [2, "第二段"], [3, "第三段"]]) {
const result = applyDelta(state, { attemptId: "a1", seq, text });
state = result.state;
console.log(result.status, state.text);
}结果先是重复、再是缺口,然后按顺序补上第二、三段。发现缺口时从最后已应用的位置请求重放,或向服务端取权威快照。若服务端没有保留历史,应提供新生成选项。原生 EventSource 的重连可以发送 Last-Event-ID,请求式流的重放则需按接口协议实现。
写出可执行的异常文案和验收条件
不要仅用“请求失败,请重试”覆盖所有状态。等待首字时显示“响应较慢,仍在等待”;流中断显示“连接已中断,已保留当前回答”;确认失败显示具体原因和“重新生成”;无法确认操作结果时显示“尚不确定任务是否已执行,请先检查状态”。
验收时至少覆盖以下场景:
- 发送前断网:草稿不丢失,不创建请求;恢复网络后由用户决定发送。
- 连续快速点击发送 5 次:只提交一次;重连不创建新任务。
- 收到 200 字后断流:已显示的 200 字保留并标记未完成;可续传时没有重字或漏字。
- 任务执行中断网:恢复后先查询原任务;结果未知时没有自动重复执行。
- 返回限流:提示等待时间,重试按钮在允许时间前禁用;没有等待时间时使用有限退避。
界面上必须始终区分“连接已经恢复”和“任务已经完成”:前者不等于后者。只有收到可信的完成状态,才能移除未完成标记并启用依赖结果的后续操作。