音频开发 / 系统课时

处理断线重连与会话恢复

处理断线重连与会话恢复

实时语音连接断开时,真正困难的不是“重新连上”,而是避免音频重复、文本乱序和上下文丢失。本节会把连接状态、心跳、退避重连、离线音频缓存和会话序列恢复组合成一套可验证的恢复机制。

学习目标

  • 用明确状态机处理连接、超时、重连和恢复,避免多个重连任务并发
  • 设计带上限和抖动的指数退避,降低故障期间的服务器冲击
  • 用音频序列号、结果序列号和服务端确认点恢复会话并去重

把连接恢复建成状态机

至少区分 CONNECTING、CONNECTED、RECONNECTING、RECOVERING 和 CLOSED。正常断网后不要直接回到“已连接”:TCP 或 WebSocket 建立成功只代表传输层恢复,旧会话是否仍存在、服务端从哪个音频序号继续接收,还需要一次恢复握手确认。

实时语音会话断线重连状态图

心跳负责发现“连接表面存在但数据已经不可达”的半开状态。心跳间隔必须小于链路或代理的空闲超时,判死时间则应允许少量网络抖动。例如可以每 15 秒发送一次心跳,连续 45 秒未收到服务端响应再进入重连;具体值要结合网关、代理和移动网络实测,而不是机械照搬。

指数退避要有上限和抖动

如果所有客户端在故障恢复后按固定 1 秒重连,会形成同步洪峰。常用做法是指数退避加 full jitter:第 n 次失败先计算上限,再在 0 到该上限之间随机选择等待时间。

下面的可运行示例同时演示退避时间和恢复点计算。随机种子固定,因此输出可复现。

python
import random

def retry_delay_ms(attempt: int, base_ms: int = 500, cap_ms: int = 8000) -> int:
    # 指数增长只决定本轮最大等待值,随机抖动避免客户端同步重连。
    ceiling = min(cap_ms, base_ms * (2 ** attempt))
    return random.randint(0, ceiling)

def resume_from(last_acked_audio_seq: int, buffered_audio_seqs: list[int]) -> list[int]:
    # 只重放服务端尚未确认的音频,已确认序号不会再次发送。
    return [seq for seq in buffered_audio_seqs if seq > last_acked_audio_seq]

random.seed(7)

for attempt in range(4):
    print(f"attempt={attempt}, delay={retry_delay_ms(attempt)} ms")

pending = resume_from(102, [101, 102, 103, 104, 105])
print(f"resume_audio={pending}")

预期输出:

text
attempt=0, delay=165 ms
attempt=1, delay=970 ms
attempt=2, delay=308 ms
attempt=3, delay=1617 ms
resume_audio=[103, 104, 105]

达到退避上限后仍应继续保持随机抖动,而不是无限指数增长。用户主动关闭会话、鉴权失败或服务端明确返回不可恢复错误时,应停止自动重连,避免后台无意义重试。

断线期间只缓存可恢复的音频

缓存策略必须同时限制“时长”和“容量”。例如允许保存最近几秒未确认音频,并记录每个音频块的递增 audioSeq。如果断线时间超过缓存上限,继续保留旧音频往往只会造成恢复后大段追赶,此时更合理的做法是丢弃最旧数据并显式记录一个音频缺口。

恢复时不要简单“把断线期间所有音频再发一遍”。客户端应保存 lastAckedAudioSeq,服务端也必须返回自己已经持久接收或处理到的确认点。两边取一致的继续位置后,只重传确认点之后的数据,才能避免同一段音频被重复识别。

恢复上下文和结果序列

一次恢复握手至少要带上 sessionId、lastAckedAudioSeq 和 lastResultSeq。服务端返回会话是否仍可恢复,以及应从哪个音频序号和结果序号继续。这样客户端既能重发缺失音频,也能丢弃已经展示过的识别结果。

一个典型恢复请求可以是:

json
{
  "type": "resume",
  "sessionId": "session-42",
  "lastAckedAudioSeq": 102,
  "lastResultSeq": 57
}

这是协议结构示例,不是独立程序。生效行为应为:服务端检查 sessionId 是否仍有效,返回确认过的音频位置和下一条结果序号;客户端只重放未确认音频,并忽略 resultSeq <= 57 的重复结果。验证时应主动制造断网,确认文本既不重复,也不会跳回旧内容。

用故障注入做验收

不要只用“正常网络下手动拔网线一次”来验证。至少覆盖连接建立失败、连接中途断开、心跳超时、恢复握手失败、断线短于缓存窗口和断线长于缓存窗口这几类情况,并记录每次状态迁移。

验收标准是:同一时刻最多只有一个重连流程;重连频率受退避控制;短断线后未确认音频能继续;已经确认的音频和结果不会重复;超过缓存能力时系统明确暴露缺口而不是悄悄堆积。做到这些,恢复机制才不仅是“自动重连”,而是可预测、可诊断的会话恢复。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理断线重连与会话恢复

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通