最近在开发实时消息系统时，频繁遇到 WebSocket 连接突然中断的情况，控制台总是弹出 closesocket:fail 的警告，错误码显示为 1006。这种非正常断开让用户体验大打折扣，尤其在移动端网络不稳定的场景下更为明显。经过一番折腾后，终于梳理出一套完整的解决方案，今天就来分享下实战经验。

为什么 1006 错误如此棘手？

WebSocket 协议规定正常关闭时应使用 1000（正常关闭）或 3000-4999（自定义状态码），而 1006 属于底层连接异常中断的特殊代码。它通常出现在：

• 移动网络切换时（4G/WiFi 切换）
• 服务端进程崩溃未发送关闭帧
• 防火墙主动切断长时间空闲连接
• 客户端设备进入休眠模式

技术方案选型

1. 标准关闭流程解读（RFC 6455）

规范中明确要求：

• 1000 表示正常关闭
• 1001 表示端点离线（如浏览器跳转页面）
• 1006 必须 不能 手动触发，仅由系统生成

// 正确的手动关闭方式（服务端/客户端均适用）
socket.close(1000, 'Normal closure');

// 错误示范！以下代码会抛出异常
socket.close(1006); // TypeError: 1006 is not allowed

2. 三大重连策略对比

| 方案 | 优点 | 缺点 | 适用场景 | |----------------|---------------------|-----------------------|------------------| | 原生立即重连 | 实现简单 | 可能引发雪崩效应 | 低并发内部系统 | | 指数退避 | 避免服务器过载 | 恢复延迟明显 | 移动端应用 | | 心跳检测 | 提前发现连接异常 | 增加电量消耗 | 金融级实时系统 |

3. 完整 TypeScript 实现

class RobustWebSocket {
  private url: string;
  private socket: WebSocket | null = null;
  private retryCount = 0;
  private maxRetries = 5;

  constructor(url: string) {
    this.url = url;
    this.connect();
  }

  private connect() {
    this.socket = new WebSocket(this.url);

    // 基础事件监听
    this.socket.onopen = () => {
      this.retryCount = 0; // 重置计数器
      this.startHeartbeat();
    };

    this.socket.onclose = (event) => {
      if (event.code !== 1000) {
        this.handleAbnormalClose(event);
      }
    };
  }

  private handleAbnormalClose(event: CloseEvent) {
    const retryDelay = Math.min(1000 * Math.pow(2, this.retryCount), 30000);

    if (this.retryCount < this.maxRetries) {
      setTimeout(() => {
        console.warn(`尝试第 ${this.retryCount + 1} 次重连...`);
        this.retryCount++;
        this.connect();
      }, retryDelay);
    } else {
      console.error(`重连失败: ${event.reason}`);
    }
  }

  private startHeartbeat() {
    // 每30秒发送Ping（实际应使用WebSocket协议级ping/pong）
    const interval = setInterval(() => {
      if (this.socket?.readyState === WebSocket.OPEN) {
        this.socket.send('__ping__');
      } else {
        clearInterval(interval);
      }
    }, 30000);
  }
}

生产环境优化要点

性能平衡艺术

• 重试策略：建议初始间隔 1s，上限 30s 的指数退避
• 心跳频率：移动端建议 30-60s，PC 端可缩短至 15s
• 负载考虑：超过 1000 个连接时，错峰重连非常重要

监控指标设计

1. 关键指标
   - 平均重连耗时
   - 重连成功率（成功次数/尝试次数）
   - 异常关闭分类统计（1006 vs 其他）

2. 报警阈值
   - 连续5分钟重连成功率 < 95%
   - 平均重连时间 > 10秒

开放性问题思考

在 Serverless 架构下，传统长连接管理面临新挑战：

• 如何在不保持实例常驻的情况下维持连接？
• 冷启动时如何快速恢复会话状态？
• 动态扩展时怎样避免连接被错误路由？

期待看到大家在这些方向的实践分享。如果你有相关经验，欢迎在评论区交流讨论！