LAN环境UDP实现WebRTC：setRemoteDescription后代码执行中断？

问题场景 #

开发无互联网依赖的LAN UDP WebRTC聊天项目，替换原Firebase通信层为UDP后，sendMessage和listenForMessage功能正常。核心逻辑中：

• OpenUserMedia、hangUp未修改，运行正常
• createRoom（主叫）可正常发送ICECandidate和Offer消息
• joinRoom（被叫）能接收ICECandidate和Offer消息，但处理Offer时，执行完await peerConnection?.setRemoteDescription(RTCSessionDescription(offer['sdp'], offer['type']))后，后续createAnswer、setLocalDescription及发送Answer的代码完全不执行，且无任何异常抛出

排查与解决方案 #

1. 确认peerConnection实例有效性 #

代码中使用peerConnection?.setRemoteDescription的可选链调用，若peerConnection未正确初始化（为null/undefined），这行代码会静默跳过，不会抛出错误，直接导致后续代码不执行。

• 修复方式：在调用前添加实例校验，去掉可选链强制暴露问题：

  if (!peerConnection) {
    console.error('peerConnection is not initialized');
    return;
  }
  await peerConnection.setRemoteDescription(new RTCSessionDescription(offer));
  

2. 验证Offer数据格式正确性 #

UDP传输过程中可能出现数据截断、序列化/反序列化错误，导致接收到的offer不符合WebRTC要求：

• 检查offer['type']必须严格为'offer'（小写字符串）
• 检查offer['sdp']是否为完整的SDP字符串，无乱码或截断
• 处理前打印完整Offer数据：console.log('Received Offer:', offer)，对比原Firebase版本的合法Offer格式

3. 为setRemoteDescription添加完整错误捕获 #

即使使用await，可选链调用会吞掉所有错误，导致无法发现问题。改用try/catch包裹，强制捕获异常：

try {
  if (!peerConnection) throw new Error('peerConnection未初始化');
  await peerConnection.setRemoteDescription(new RTCSessionDescription(offer));
  
  // 后续createAnswer等逻辑
  const answer = await peerConnection.createAnswer();
  await peerConnection.setLocalDescription(answer);
  sendMessage({ type: 'answer', sdp: answer.sdp });
} catch (err) {
  console.error('处理Offer失败:', err);
}

4. 排查UDP消息序列化/反序列化问题 #

若发送端用JSON.stringify序列化Offer，接收端需确保用JSON.parse正确解析：

• 检查UDP接收的原始数据是否完整，无字节丢失
• 验证反序列化后的offer对象结构与发送端完全一致，不存在键名拼写错误（比如sdp写成SDP）

5. 适配LAN环境的ICE配置 #

原Firebase版本可能依赖公共STUN服务器，LAN环境下需调整ICE配置避免无效请求：

• 初始化RTCPeerConnection时，可配置仅使用主机候选（无需STUN）：

  const peerConnection = new RTCPeerConnection({
    iceServers: [] // 空数组表示仅使用本地主机候选
  });
  

• 错误的ICE配置可能导致setRemoteDescription后连接状态异常，阻塞后续流程

6. 检查自动协商事件冲突 #

原代码可能保留了onnegotiationneeded事件监听，该事件会触发自动协商，与手动创建Answer的逻辑冲突：

• 移除不必要的peerConnection.onnegotiationneeded监听，确保手动流程完全可控

内容的提问来源于stack exchange，提问作者Diogo Bratti