LiveKit本地正常但AWS Docker部署报错：PublishTrackError求助

故障类别 #

这属于生产环境WebRTC媒体传输/连接故障，核心原因是AWS部署环境的网络配置（Nginx代理、EC2安全组、NAT穿透）导致LiveKit客户端与云服务的信令或媒体流连接中断，进而引发轨道发布超时、Peer连接关闭的连锁错误。

下一步排查方向 #

1. 网络连通性与ICE配置验证 #

• EC2安全组检查：确保开放WebRTC所需端口：
  • TCP 443（信令/WebSocket）
  • UDP 50000-60000（媒体流传输，LiveKit默认范围）
• Nginx代理配置修正：WebRTC需要支持WebSocket升级和UDP转发，检查配置是否包含以下关键项：

  # 信令/WebSocket转发
  location /livekit/ {
      proxy_pass https://your-livekit-cloud-endpoint;
      proxy_http_version 1.1;
      proxy_set_header Upgrade $http_upgrade;
      proxy_set_header Connection "upgrade";
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
  }
  
  # UDP媒体流转发（若Nginx作为UDP代理）
  stream {
      server {
          listen 50000-60000 udp;
          proxy_pass your-livekit-cloud-udp-endpoint;
          proxy_timeout 30s;
      }
  }
  

• ICE服务器配置确认：前端连接LiveKit时，确保使用的ICE服务器包含STUN/TURN（LiveKit Cloud默认提供STUN，若EC2处于严格NAT环境，需启用LiveKit的TURN服务），示例代码：

  const room = new Room({
      iceServers: [
          { urls: 'stun:stun.livekit.io:3478' },
          // 若启用TURN，添加对应配置
          { urls: 'turn:turn.livekit.io:3478', username: 'xxx', credential: 'xxx' }
      ]
  });
  

2. Docker容器网络检查 #

• 容器连通性测试：进入Docker容器内部，执行命令测试LiveKit Cloud端点的可达性：

  # 测试HTTPS信令端点
  curl -v https://your-livekit-cloud-endpoint
  # 测试UDP端口连通性
  nc -zv -u your-livekit-cloud-endpoint 50000
  

• 容器DNS验证：检查容器内DNS是否能正确解析LiveKit域名：

  nslookup your-livekit-cloud-endpoint
  

3. LiveKit客户端配置调整 #

• 延长连接超时时间：生产环境网络延迟可能更高，调整房间连接的超时参数：

  await room.connect(token, {
      timeout: 30000 // 从默认10秒延长至30秒
  });
  

• 媒体轨道发布逻辑优化：确保在Peer连接状态变更时停止无效的轨道发布操作，示例：

  room.on('disconnected', () => {
      // 停止所有本地轨道发布
      room.localParticipant.tracks.forEach(track => {
          track.stop();
          room.localParticipant.unpublishTrack(track.track);
      });
  });
  

4. 日志与监控分析 #

• LiveKit Cloud日志：在LiveKit控制台查看对应房间的连接日志，重点关注ICE候选收集状态、参与者连接断开的原因。
• Nginx日志排查：查看Nginx的access.log和error.log，确认是否存在WebSocket升级失败、UDP转发错误的记录。
• 前端Debug日志：开启LiveKit客户端的Debug日志，获取更详细的连接过程信息：

  import { setLogLevel } from 'livekit-client';
  setLogLevel('debug');
  

内容的提问来源于stack exchange，提问作者Niteesh Gowda C