最近在项目中处理WebSocket连接时，遇到了一个让人头疼的错误提示：closesocket:fail failed to execute 'close' on 'websocket': the code must be either 1000, or between 3000 and 4999. 1006 is neither.。这个错误看似简单，却涉及WebSocket协议的底层规范。今天就来分享一下我的解决思路和实战经验。

一、WebSocket关闭状态码规范

根据RFC6455标准，WebSocket连接的关闭必须使用特定状态码：

• 1000：正常关闭，表示连接已完成预期工作
• 1001-1015：保留状态码，通常由协议内部使用
• 3000-4999：应用自定义状态码范围

特别要注意的是，1006是一个特殊状态码，表示连接异常关闭，但它不能被手动设置。这就是我们遇到错误的原因。

二、错误场景分析

常见的错误场景包括：

1. 网络中断导致的非正常断开
2. 服务端崩溃未发送关闭帧
3. 客户端错误地尝试设置1006状态码
4. 防火墙或代理中断连接

三、解决方案与代码实现

客户端实现（JavaScript）

class WSClient {
  constructor(url) {
    this.url = url;
    this.reconnectAttempts = 0;
    this.maxReconnectAttempts = 5;
    this.connect();
  }

  connect() {
    this.ws = new WebSocket(this.url);

    this.ws.onopen = () => {
      console.log('连接已建立');
      this.reconnectAttempts = 0; // 重置重连计数
    };

    this.ws.onclose = (event) => {
      // 正确处理关闭事件
      if (event.code === 1000) {
        console.log('连接正常关闭');
        return;
      }

      console.warn(`连接断开，代码: ${event.code}, 原因: ${event.reason}`);
      this.handleReconnect();
    };

    this.ws.onerror = (error) => {
      console.error('连接错误:', error);
      this.ws.close(3001, 'Connection error'); // 使用自定义错误码
    };
  }

  // 安全关闭连接
  safeClose(code = 1000, reason = '正常关闭') {
    if (code !== 1000 && (code < 3000 || code > 4999)) {
      console.warn('无效的关闭代码，使用默认值1000');
      code = 1000;
    }
    this.ws.close(code, reason);
  }

  // 重连逻辑
  handleReconnect() {
    if (this.reconnectAttempts < this.maxReconnectAttempts) {
      this.reconnectAttempts++;
      const delay = Math.min(1000 * this.reconnectAttempts, 5000);
      console.log(`将在${delay}ms后尝试重连...`);
      setTimeout(() => this.connect(), delay);
    } else {
      console.error('达到最大重连次数，放弃连接');
    }
  }
}

服务端实现（Node.js）

const WebSocket = require('ws');

const wss = new WebSocket.Server({ port: 8080 });

wss.on('connection', (ws) => {
  console.log('新客户端连接');

  // 心跳检测
  const heartbeatInterval = setInterval(() => {
    if (ws.readyState === WebSocket.OPEN) {
      ws.ping();
    }
  }, 30000);

  ws.on('close', (code, reason) => {
    clearInterval(heartbeatInterval);

    // 验证关闭代码
    if (code !== 1000 && (code < 3000 || code > 4999)) {
      console.warn(`收到无效关闭代码: ${code}`);
    }

    console.log(`客户端断开连接，代码: ${code}, 原因: ${reason}`);
  });

  ws.on('error', (error) => {
    console.error('连接错误:', error);
    ws.close(3002, 'Server error');
  });
});

四、生产环境最佳实践

1. 心跳机制：定期发送ping/pong帧检测连接活性
2. 优雅关闭：确保所有消息处理完成后再关闭连接
3. 资源清理：关闭连接时清除所有相关资源和定时器
4. 日志记录：详细记录连接关闭的原因和状态码
5. 重试策略：实现指数退避算法进行重连

五、跨语言/框架差异

不同平台对WebSocket的实现略有差异：

• 浏览器端：API标准化程度高，但受同源策略限制
• Node.js：ws库功能强大，但需要手动处理更多细节
• Java：Jetty和Tomcat等容器提供不同级别的支持
• Python：websockets库提供异步IO支持

六、性能优化建议

1. 使用连接池管理大量WebSocket连接
2. 避免在单个连接上堆积太多未处理消息
3. 合理设置缓冲区大小
4. 考虑使用消息压缩减少带宽消耗

通过以上实践，我们不仅解决了最初的错误问题，还建立了一套健壮的WebSocket连接管理机制。建议在自己的项目中根据实际需求调整重连策略和错误处理逻辑，确保网络通信的可靠性。

最后提醒：WebSocket虽然强大，但并非所有场景都适用。对于简单的请求-响应模式，HTTP/2可能是更好的选择。