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。

需要特别区分三个状态: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。
// 片段示例:依赖已建立的 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。
// 片段示例:在已有 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 和字节数均以实际浏览器结果为准。
{
iceState: 'connected',
pairId: '<ID>',
pairState: 'succeeded',
localType: 'srflx',
remoteType: 'relay',
bytesSent: 4096,
bytesReceived: 3072
}<ID> 代表浏览器生成的统计标识符;字节数只是示例值。某些浏览器版本或统计实现可能不提供部分可选字段,此时应结合 chrome://webrtc-internals(Chromium 系浏览器)或相应浏览器的 WebRTC 诊断工具检查。

完成网络切换后,按以下步骤验收:
- 记录切换前的
iceConnectionState、选中候选对 ID 和 DataChannel 状态。 - 切换网络并观察是否出现
disconnected、checking或failed。实际事件顺序可能不同。 - 检查信令日志,确认新 Offer 的
ice-ufrag与旧协商不同,并收到对应 Answer。 - 检查候选对是否重新选定、ICE 是否恢复
connected或completed。候选对 ID 可能改变,但不要求必然改变。 - 使用原有 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 配置能够提供中继候选。只有多种网络变化场景都能完成业务层双向验收,才能认为恢复策略具备上线条件。