WebRTC局域网内正常，公网无法连接问题求助

核心排查方向 #

1. TURN服务器配置有效性验证 #

• 确认TURN服务器的urls、username、credential完全正确，免费TURN服务常存在并发数、地域、有效期限制，可通过以下方式验证：
  • 在前端添加日志，打印iceGatheringState的变化，以及收集到的ICE候选地址类型（host/srflx/relay），如果没有relay类型候选，说明TURN配置未生效。
  • 检查协议与端口匹配性，部分免费服务要求使用turns（TLS加密）而非turn，端口对应5349而非3478。

2. Django Channels信令完整性检查 #

• 虽然能接收offer和answer，但必须确认ICE候选是否完整传递：
  • 前端onicecandidate事件中，需确保每一个生成的ICE候选都通过信令通道发送，ICE候选会分批生成，不能只发送第一个或最后一个。
  • 排查后端是否正确转发所有ICE候选，是否存在消息大小限制或过滤规则导致候选数据丢失。

3. 前端RTCPeerConnection配置细节 #

• 显式声明sdpSemantics: 'unified-plan'，部分旧环境不会默认启用该标准，可能导致SDP兼容性问题。
• 确认iceServers格式正确，示例如下：

  const config = {
    iceServers: [
      {
        urls: 'turn:your-turn-server.com:3478',
        username: 'your-username',
        credential: 'your-password'
      }
    ]
  };
  const peerConnection = new RTCPeerConnection(config);
  

  避免将urls写成错误的数组嵌套格式，或遗漏username/credential字段。

4. 网络与防火墙限制排查 #

• 让异地用户测试telnet连接TURN服务器的对应端口（如3478/5349），确认其网络未阻止TURN端口访问（部分公司/校园网络会限制此类端口）。
• 确认Django Channels服务部署在公网可访问地址，WebSocket连接需稳定，信令通道断连或高延迟会直接影响ICE协商。

前端代码重点检查点 #

针对典型WebRTC前端逻辑，重点核查以下部分：

// 1. PeerConnection初始化
const pc = new RTCPeerConnection({
  iceServers: [
    // 确认此处TURN配置无拼写、格式错误
    { urls: 'turn:metered.live:3478', username: 'xxx', credential: 'xxx' }
  ],
  sdpSemantics: 'unified-plan' // 显式声明统一计划格式
});

// 2. ICE候选发送逻辑
pc.onicecandidate = (event) => {
  if (event.candidate) {
    // 确保每个候选都实时发送，无延迟或过滤
    sendToServer({ type: 'ice-candidate', candidate: event.candidate });
  }
};

// 3. 远端候选接收逻辑
function handleIceCandidate(data) {
  if (data.candidate) {
    pc.addIceCandidate(new RTCIceCandidate(data.candidate))
      .catch(err => console.error('添加ICE候选失败:', err)); // 捕获并打印错误
  }
}

// 4. SDP处理逻辑
async function createOffer() {
  const offer = await pc.createOffer();
  await pc.setLocalDescription(offer);
  sendToServer({ type: 'offer', sdp: pc.localDescription });
}

async function handleOffer(data) {
  await pc.setRemoteDescription(new RTCSessionDescription(data.sdp));
  const answer = await pc.createAnswer();
  await pc.setLocalDescription(answer);
  sendToServer({ type: 'answer', sdp: pc.localDescription });
}

• 检查onicecandidate是否在候选生成时立即触发发送，无逻辑延迟。
• 确认addIceCandidate的错误捕获已启用，通过控制台查看是否存在候选格式错误。

额外测试建议 #

• 用同一公网环境下的不同设备测试（如手机4G+家用WiFi），排除异地网络的特殊限制。
• 尝试付费TURN服务器的免费额度（如Twilio、Vonage），排除免费服务的稳定性问题。

内容的提问来源于stack exchange，提问作者Taha Zolfi