Node.js中ws库无法设置WebSocket协议，原生JS可正常配置

数据老陈

2026-6-23

解决ws库在Node.js中无法设置graphql-ws协议的问题

核心问题定位

你遇到的协议为空问题，本质是ws库的参数格式和浏览器原生WebSocket存在差异，加上错误的连接状态等待方式导致的。

正确设置graphql-ws协议的三种方式

ws库的WebSocket构造函数对协议参数的要求和浏览器原生略有不同，以下是三种有效传参方式：

直接传递协议字符串作为第二个参数

const WebSocket = require('ws');
const ws = new WebSocket('wss://your-graphql-endpoint', 'graphql-ws');

传递协议数组作为第二个参数

const ws = new WebSocket('wss://your-graphql-endpoint', ['graphql-ws']);

通过选项对象传递（注意字段名是protocols而非protocol）
你之前用{protocol: "graphql-ws"}是错误的，ws库识别的字段是复数形式的protocols：

const ws = new WebSocket('wss://your-graphql-endpoint', { protocols: 'graphql-ws' });

正确处理连接状态（替代休眠/轮询）

不要用休眠函数或无限循环等待readyState，ws库基于事件驱动，应该通过监听事件来处理连接生命周期：

// 连接成功触发
ws.on('open', () => {
  console.log('连接成功，使用协议:', ws.protocol); // 此处应输出graphql-ws
  // 在这里执行graphql-ws的初始化逻辑，比如发送connection_init消息
});

// 连接错误触发
ws.on('error', (err) => {
  console.error('连接失败:', err.message);
});

// 收到消息触发
ws.on('message', (data) => {
  console.log('收到服务器消息:', data.toString());
});