EasyRTC进入会议室控制台websocket出现pending状态该如何解决

# EasyRTC进入会议室控制台WebSocket出现pending状态该如何解决

## 问题现象
当用户通过EasyRTC进入视频会议室时，控制台WebSocket连接长时间处于`pending`状态，导致无法正常建立音视频通信。开发者工具Network面板显示WebSocket请求卡在握手阶段，控制台可能伴随以下报错：

WebSocket connection to ‘wss://xxx’ failed

## 原因分析
出现该问题的常见原因包括：

1. **网络策略限制**
   - 防火墙/安全组拦截WebSocket端口（默认443/80）
   - 企业网络禁用非标准WebSocket路径

2. **SSL证书问题**
   - 自签名证书未受信任
   - 证书链不完整
   - 证书域名不匹配

3. **服务端配置**
   - WebSocket服务未正常运行
   - Nginx/Apache未正确配置代理
   - 服务端连接数达到上限

4. **客户端因素**
   - 浏览器插件阻止连接
   - 本地hosts文件错误解析

## 解决方案

### 一、基础检查
```bash
# 测试WebSocket服务可达性
curl -I https://yourdomain.com/ws
telnet yourdomain.com 443

二、服务端配置

1. Nginx反向代理配置示例

location /ws {
    proxy_pass http://backend;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_read_timeout 86400;
}

1. 检查关键配置
   • 确保wss://协议使用TLS 1.2+
   • 验证证书有效性：

     
     openssl s_client -connect yourdomain.com:443 -servername yourdomain.com
     

三、客户端处理

1. 浏览器端调试：

   // 测试基础连接
   const ws = new WebSocket('wss://yourdomain.com/ws');
   ws.onerror = (e) => console.error(e);
   

2. 临时解决方案：

   • 尝试切换HTTP/HTTPS协议
   • 使用ws://进行本地测试（非生产环境）

四、高级排查

1. 抓包分析

   tcpdump -i any -w websocket.pcap port 443
   

2. 服务端日志检查

   • WebSocket服务日志（如Socket.IO、SignalR）
   • 查看操作系统连接限制：

     
     sysctl net.core.somaxconn
     

预防措施

1. 实现WebSocket心跳机制：

   setInterval(() => {
    ws.send('ping');
   }, 30000);
   

2. 部署前验证：

   • 使用WebSocket在线测试工具
   • 通过Postman进行WebSocket测试

3. 监控建议：

   • 配置WebSocket连接失败告警
   • 监控服务端WS连接数变化

提示：若问题持续存在，建议收集以下信息提交给EasyRTC技术支持： 1. 浏览器版本及完整报错截图 2. 服务端/客户端日志文件 3. 网络拓扑结构说明 “`

该文档包含问题现象描述、原因分析、具体解决方案及预防措施，采用Markdown格式便于技术文档管理。实际应用中需根据具体环境调整配置参数。