WebRTC跨网络视频通话异常问题排查与解决请求

问题核心原因 #

同一网络下通话正常，切换网络后失效，本质是网络环境变化导致原有的ICE候选地址全部失效，但当前代码没有监听网络变化事件，也未触发重新协商流程，即便配置了STUN/TURN，旧连接也无法自动切换到新的网络链路。

代码中的关键问题点 #

1. 未监听设备网络状态变化，无法感知网络切换事件
2. onnegotiationneeded仅在初始连接时触发，网络变化后不会自动启动重新协商
3. onconnectionstatechange未处理disconnected/failed状态的重连逻辑
4. 音频流处理存在逻辑错误：移除音频流时误操作了视频轨道

修复步骤及代码修改 #

1. 添加网络变化监听 #

在createpeerConnection方法内，创建RTCPeerConnection之后添加网络状态监听：

// 监听设备网络连接变化
if (navigator.connection) {
  navigator.connection.onchange = () => {
    this.handleNetworkChange(connid);
  };
}

2. 实现网络切换后的重协商逻辑 #

新增处理网络变化的方法，重新收集ICE候选并发起SDP协商：

async handleNetworkChange(connid) {
  const peerConn = this.peers_conns[connid];
  if (!peerConn || peerConn.signalingState === 'closed') return;

  try {
    // 重启ICE候选收集，生成适配当前网络的新候选地址
    await peerConn.restartIce();
    // 仅在信令状态稳定时发起新协商
    if (peerConn.signalingState === 'stable') {
      await peerConn.setLocalDescription(await peerConn.createOffer());
      this._serverFn(JSON.stringify({ 'offer': peerConn.localDescription }), connid);
    }
  } catch (err) {
    console.error('网络切换重协商失败:', err);
  }
}

3. 完善连接状态变化的处理 #

修改handleIceConnectionStateChangeEvent方法，在连接断开时自动触发重连：

async handleIceConnectionStateChangeEvent(event) {
  const peerConn = event.target;
  const connid = Object.keys(this.peers_conns).find(key => this.peers_conns[key] === peerConn);
  if (!connid) return;

  switch (peerConn.iceConnectionState) {
    case 'disconnected':
    case 'failed':
      console.log('ICE连接断开，启动重连流程');
      await this.handleNetworkChange(connid);
      break;
    case 'closed':
      console.log('连接已关闭，清理资源');
      delete this.peers_conns[connid];
      delete this._remoteVideoStreams[connid];
      delete this._remoteAudioStreams[connid];
      break;
  }
}

4. 修复音频流处理的逻辑错误 #

修正ontrack中音频轨道移除的错误：

// 原错误代码
this._remoteAudioStreams[connid].getVideoTracks().forEach(t => this._remoteAudioStreams[connid].removeTrack(t));
// 修改为
this._remoteAudioStreams[connid].getAudioTracks().forEach(t => this._remoteAudioStreams[connid].removeTrack(t));

验证方法 #

1. 切换网络后，查看浏览器控制台是否输出ICE连接断开，启动重连流程等日志
2. 检查信令服务器是否收到新的SDP Offer和ICE候选，并成功转发给对端
3. 验证STUN/TURN服务器配置有效性，确保TURN能生成中继候选地址

内容的提问来源于stack exchange，提问作者Jass Tech