音频开发 / 系统课时
处理断线重连与会话恢复
处理断线重连与会话恢复
实时语音连接断开时,真正困难的不是“重新连上”,而是避免音频重复、文本乱序和上下文丢失。本节会把连接状态、心跳、退避重连、离线音频缓存和会话序列恢复组合成一套可验证的恢复机制。
学习目标
- 用明确状态机处理连接、超时、重连和恢复,避免多个重连任务并发
- 设计带上限和抖动的指数退避,降低故障期间的服务器冲击
- 用音频序列号、结果序列号和服务端确认点恢复会话并去重
把连接恢复建成状态机
至少区分 CONNECTING、CONNECTED、RECONNECTING、RECOVERING 和 CLOSED。正常断网后不要直接回到“已连接”:TCP 或 WebSocket 建立成功只代表传输层恢复,旧会话是否仍存在、服务端从哪个音频序号继续接收,还需要一次恢复握手确认。

心跳负责发现“连接表面存在但数据已经不可达”的半开状态。心跳间隔必须小于链路或代理的空闲超时,判死时间则应允许少量网络抖动。例如可以每 15 秒发送一次心跳,连续 45 秒未收到服务端响应再进入重连;具体值要结合网关、代理和移动网络实测,而不是机械照搬。
指数退避要有上限和抖动
如果所有客户端在故障恢复后按固定 1 秒重连,会形成同步洪峰。常用做法是指数退避加 full jitter:第 n 次失败先计算上限,再在 0 到该上限之间随机选择等待时间。
下面的可运行示例同时演示退避时间和恢复点计算。随机种子固定,因此输出可复现。
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}")预期输出:
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。服务端返回会话是否仍可恢复,以及应从哪个音频序号和结果序号继续。这样客户端既能重发缺失音频,也能丢弃已经展示过的识别结果。
一个典型恢复请求可以是:
{
"type": "resume",
"sessionId": "session-42",
"lastAckedAudioSeq": 102,
"lastResultSeq": 57
}这是协议结构示例,不是独立程序。生效行为应为:服务端检查 sessionId 是否仍有效,返回确认过的音频位置和下一条结果序号;客户端只重放未确认音频,并忽略 resultSeq <= 57 的重复结果。验证时应主动制造断网,确认文本既不重复,也不会跳回旧内容。
用故障注入做验收
不要只用“正常网络下手动拔网线一次”来验证。至少覆盖连接建立失败、连接中途断开、心跳超时、恢复握手失败、断线短于缓存窗口和断线长于缓存窗口这几类情况,并记录每次状态迁移。
验收标准是:同一时刻最多只有一个重连流程;重连频率受退避控制;短断线后未确认音频能继续;已经确认的音频和结果不会重复;超过缓存能力时系统明确暴露缺口而不是悄悄堆积。做到这些,恢复机制才不仅是“自动重连”,而是可预测、可诊断的会话恢复。