P2P 与分布式存储 / 系统课时

网络切换后触发 ICE Restart

网络切换后触发 ICE Restart

当设备从 Wi-Fi 切换到移动网络,或 VPN、网络接口发生变化时,WebRTC 原有的候选地址和传输路径可能失效。本课通过浏览器双端实验,触发 ICE Restart、重新交换信令并检查候选对,验证已有 DataChannel 会话能否在不重建 RTCPeerConnection 的情况下恢复通信。

学习目标

  • 判断网络切换后何时需要 ICE Restart,区分临时断连与永久失败。
  • 使用 restartIce() 和 Offer/Answer 信令完成重新协商。
  • 通过连接状态、候选对统计和 DataChannel 消息验证恢复效果。

网络切换为什么会导致旧路径失效

ICE(Interactive Connectivity Establishment)负责在本地与远端候选地址之间检查可达性并选择传输路径。原先选定的候选对可能依赖旧 Wi-Fi 的局域网地址、NAT 映射或公网出口。一旦切换网络,这些条件就可能不再成立。

例如,设备原来通过 Wi-Fi 使用 192.168.1.20 对应的候选地址,切换到另一网络后获得 10.20.0.15。旧候选对即使曾经通过检查,也不能保证继续收发数据。以上地址仅用于说明,不代表浏览器一定会向 JavaScript 暴露真实本地 IP。

ICE Restart 会为新的 ICE 协商生成不同的 ice-ufrag 和 ice-pwd,重新收集候选并执行连通性检查。它不会自动创建新的 RTCPeerConnection,也不要求重新创建已有的 DataChannel。

网络切换前后 ICE 候选路径与 Restart 恢复过程

需要特别区分三个状态:disconnected 可能只是暂时失去连通性;failed 表示 ICE 检查已失败;closed 表示连接对象已关闭,不能通过 Restart 重新打开。网络变化时也可能先保持 connected,因此不能仅凭一次状态事件判断恢复结果。

选择 Restart 的触发时机

生产环境应同时观察 iceConnectionState 和网络变化事件,而不是收到一次 disconnected 就立即发起协商。

观察条件 建议处理
disconnected 持续不足 3 秒 继续观察,允许 ICE 自行恢复
disconnected 持续达到 3 秒 发起一次 ICE Restart
failed 尽快触发 ICE Restart
connected 或 completed 取消等待中的重启定时器
closed 停止恢复,按业务逻辑创建新连接

这里的 3 秒是本实验采用的应用层防抖参数,不是 WebRTC 协议规定的超时时间。弱网、移动端休眠或频繁切换场景需要结合真实恢复数据调整。

浏览器的 online、offline 事件只能反映浏览器报告的联网状态,不能证明远端 ICE 路径可达。它们适合作为辅助信号,最终仍应以 ICE 状态和实际数据收发为准。

实现网络变化后的 ICE Restart

下面是可接入现有 WebRTC 双端应用的片段示例。假设 pc 是已经建立连接的 RTCPeerConnection,sendSignal(message) 会将 JSON 信令消息可靠地发送给远端,远端也已经实现 Offer/Answer 和 Trickle ICE 处理。

示例使用 restartIce() 请求下一次协商执行 ICE Restart,并通过 negotiationneeded 事件生成 Offer。代码中的信令发送接口是项目自定义函数,并非浏览器原生 API。

js
// 片段示例:依赖已建立的 pc 和项目提供的 sendSignal()
let restartTimer = null;
let makingOffer = false;
let pendingNegotiation = false;

async function negotiate() {
  if (makingOffer || pc.signalingState !== 'stable') {
    pendingNegotiation = true;
    return;
  }

  makingOffer = true;
  try {
    await pc.setLocalDescription();
    await sendSignal({
      type: 'description',
      description: pc.localDescription
    });
  } catch (error) {
    console.error('协商失败', error);
  } finally {
    makingOffer = false;
    if (pendingNegotiation && pc.signalingState === 'stable') {
      pendingNegotiation = false;
      queueMicrotask(() => void negotiate());
    }
  }
}

pc.addEventListener('negotiationneeded', () => {
  void negotiate();
});

function requestIceRestart() {
  if (pc.signalingState === 'closed') return;
  if (pc.signalingState !== 'stable') {
    // 不稳定期间记住请求,后续回到 stable 再协商。
    pc.restartIce();
    return;
  }
  pc.restartIce();
}

pc.addEventListener('iceconnectionstatechange', () => {
  const state = pc.iceConnectionState;
  console.log('ICE 状态:', state);
  clearTimeout(restartTimer);
  restartTimer = null;

  if (state === 'failed') {
    requestIceRestart();
  } else if (state === 'disconnected') {
    restartTimer = setTimeout(() => {
      if (pc.iceConnectionState === 'disconnected') {
        requestIceRestart();
      }
    }, 3000);
  }
});

window.addEventListener('online', () => {
  if (pc.iceConnectionState === 'disconnected' ||
      pc.iceConnectionState === 'failed') {
    requestIceRestart();
  }
});

restartIce() 不会直接发送 Offer,也不返回完成恢复的 Promise。它通知连接对象在后续协商中使用新的 ICE 凭据。调用后仍须通过信令服务器把本地 SDP 传递给远端,并正确处理远端 Answer 和新的 ICE 候选。

在现有信令处理器中,收到远端 Answer 后执行 await pc.setRemoteDescription(answer);收到远端 ICE candidate 后执行 await pc.addIceCandidate(candidate)。收到远端 Offer 的一侧也必须完成 setRemoteDescription(offer)、setLocalDescription() 和 Answer 回传。上述处理应由统一协商器串行执行。

本片段只覆盖重启触发与发起端协商,不是完整的 Perfect Negotiation 实现。完整项目还需处理 Offer 冲突、远端协商事件、信令断线重连,以及协商失败后的有限次数重试。对持续处于 failed 的连接应设置退避和总恢复预算,避免形成无休止的协商循环。

验证新候选对与 DataChannel 恢复

测试时在两个浏览器标签页或两台设备上建立 DataChannel。先确保双方能够正常发送消息,再切换其中一端的 Wi-Fi、移动热点或 VPN。建议分别记录切换前、切换后和恢复后的 ICE 状态及统计数据。

以下是可在浏览器开发者工具 Console 中执行的统计检查片段。运行前需要页面暴露已建立的 pc 变量,并确保当前浏览器支持标准 WebRTC Stats API。

js
// 片段示例:在已有 RTCPeerConnection 的页面中执行
async function inspectSelectedPair(pc) {
  const stats = await pc.getStats();
  const transports = [...stats.values()].filter(
    item => item.type === 'transport' && item.selectedCandidatePairId
  );

  for (const transport of transports) {
    const pair = stats.get(transport.selectedCandidatePairId);
    if (!pair) continue;

    const local = stats.get(pair.localCandidateId);
    const remote = stats.get(pair.remoteCandidateId);
    console.log({
      iceState: pc.iceConnectionState,
      pairId: pair.id,
      pairState: pair.state,
      localType: local?.candidateType,
      remoteType: remote?.candidateType,
      bytesSent: pair.bytesSent,
      bytesReceived: pair.bytesReceived
    });
  }
}

await inspectSelectedPair(pc);

预期结果是在连接恢复后能够查询到当前选中的候选对,iceState 通常为 connected 或 completed,候选对状态通常为 succeeded。以下仅为输出结构示意,候选类型、统计 ID 和字节数均以实际浏览器结果为准。

text
{
  iceState: 'connected',
  pairId: '<ID>',
  pairState: 'succeeded',
  localType: 'srflx',
  remoteType: 'relay',
  bytesSent: 4096,
  bytesReceived: 3072
}

<ID> 代表浏览器生成的统计标识符;字节数只是示例值。某些浏览器版本或统计实现可能不提供部分可选字段,此时应结合 chrome://webrtc-internals(Chromium 系浏览器)或相应浏览器的 WebRTC 诊断工具检查。

ICE Restart 双端协商与恢复验收时序图

完成网络切换后,按以下步骤验收:

  1. 记录切换前的 iceConnectionState、选中候选对 ID 和 DataChannel 状态。
  2. 切换网络并观察是否出现 disconnected、checking 或 failed。实际事件顺序可能不同。
  3. 检查信令日志,确认新 Offer 的 ice-ufrag 与旧协商不同,并收到对应 Answer。
  4. 检查候选对是否重新选定、ICE 是否恢复 connected 或 completed。候选对 ID 可能改变,但不要求必然改变。
  5. 使用原有 DataChannel 发送带唯一序号的 PING,让远端返回相同序号的 PONG,确认双向业务通信恢复。

只有 ICE 状态恢复并不等于业务已经可用。DataChannel 的 readyState 仍应为 open,且消息应在设定的业务超时内得到响应。若通道已经 closed,不能通过 ICE Restart 将它重新打开,需要按业务协议重新建立通道或连接。

处理恢复失败与生产环境边界

网络切换后若始终无法恢复,先检查信令,再检查候选收集和 TURN 可达性,不要直接销毁连接对象。

故障现象 优先检查项 修复方向
调用 Restart 后没有新 Offer signalingState、negotiationneeded 和协商锁 等待稳定状态并恢复协商队列
新 Offer 发出但没有 Answer WebSocket 连接与远端信令处理 重连信令并重新协调协商
Answer 完成但 ICE 持续失败 新候选、NAT、UDP 和 TURN 可达性 验证 TURN 凭据及中继端口
ICE 恢复但业务无响应 DataChannel 状态、消息超时与应用层协议 检查收发处理及业务会话状态

建议生产环境记录 restartAttempt、restartReason、iceState、协商开始时间、恢复完成时间、最终候选类型和业务探测结果。一次恢复成功的判据应包括 ICE 连通性、DataChannel 可用性和实际消息响应,而非仅依赖状态回调。

可将单次恢复观察窗口初始设为 15 秒、最多尝试 3 次,失败后再考虑重建 RTCPeerConnection。这些数值是可调整的应用策略,不是协议默认值。重建连接可能影响原有 DataChannel、媒体轨道和业务会话,应由上层状态管理明确处理。

最后还应分别测试 Wi-Fi 切移动热点、移动热点切回 Wi-Fi、VPN 开关以及 TURN-only 模式。直连受限时,确保有效的 TURN 配置能够提供中继候选。只有多种网络变化场景都能完成业务层双向验收,才能认为恢复策略具备上线条件。

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

目录与阅读设置

阅读设置

17

记录一个想法

网络切换后触发 ICE Restart

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

登录哪都通