WebSocket连接异常分析：如何解决close code=1008 unauthorized错误

1次阅读

共计 1733 个字符，预计需要花费 5 分钟才能阅读完成。

WebSocket 协议在关闭连接时会发送一个关闭状态码（close code），用来指示连接关闭的原因。这些状态码在 RFC6455 中有明确定义，其中 1008 表示 ”Policy Violation”（策略违反），通常用于身份验证失败或授权问题。当服务端检测到客户端请求缺少必要的认证凭据（如 gateway token）时，就会返回这个状态码并终止连接。

在 WebSocket 连接建立过程中，身份验证通常发生在握手阶段。服务端需要在 upgrade 请求中验证客户端的认证信息。当服务端配置要求 gateway token 但客户端未提供时，就会触发 1008 错误。这个过程主要涉及以下几个环节：

客户端发起 WebSocket 连接请求
服务端检查请求头或查询参数中的认证 token
发现 token 缺失或无效时，服务端响应关闭帧（close frame）
连接被强制终止

const WebSocket = require('ws');
const jwt = require('jsonwebtoken');

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

server.on('connection', (ws, req) => {
  // 1. 从查询参数获取 token
  const token = req.url.split('token=')[1];

  // 2. 验证 token
  if (!token) {ws.close(1008, 'unauthorized: gateway token missing');
    return;
  }

  try {const decoded = jwt.verify(token, 'your-secret-key');
    // 3. 验证通过，处理连接
    ws.on('message', (message) => {console.log(`Received: ${message}`);
    });
  } catch (err) {ws.close(1008, 'unauthorized: invalid token');
  }
});

客户端需要正确处理连接关闭事件，特别是 1008 错误：

const ws = new WebSocket('ws://localhost:8080');

ws.onopen = () => {console.log('Connected');
};

ws.onclose = (event) => {if (event.code === 1008) {console.error('Authentication failed:', event.reason);
    // 重新获取 token 并重连
    fetchNewTokenAndReconnect();} else {console.log('Disconnected:', event.code, event.reason);
  }
};