WebSocket在原生JS中连接正常，Node.js中无法建立连接求助

我尝试连接的WebSocket地址为：
wss://xxx.xxx.com/public/time/player/test/xxx/socket?messageFormat=json&SESSIONID=xxx&instance=xxx&client_version=xxx

该连接在浏览器原生JavaScript中可正常运行，能接收所有消息，但在Node.js环境下始终无法建立连接。我已经尝试使用websocket、wb等不同的WebSocket包，均未成功。

浏览器原生JavaScript代码（可正常运行） #

const socketUrl = 'wss://xxx.xxx.com/public/time/player/test/xxx/socket?messageFormat=json&SESSIONID=xxx&instance=xxx&client_version=xxx';

const socket = new WebSocket(socketUrl);

socket.onopen = function(event) {
    console.log("Connection opened:", event);
};

socket.onmessage = function(event) {
    console.log("Message received:", event.data);
};

socket.onerror = function(error) {
    console.error("WebSocket error:", error);
};

socket.onclose = function() {
    console.log("Connection closed");
};

Node.js代码（无法建立连接，卡在CONNECTING状态） #

const socketUrl = 'wss://xxx.xxx.com/public/time/player/test/xxx/socket?messageFormat=json&SESSIONID=xxx&instance=xxx&client_version=xxx';

const WebSocket = require("ws");

const connect = () => {
  const socket = new WebSocket(socketUrl);
  
  // 卡在CONNECTING状态
  socket.on("open", () => {
    console.log("Connected to socket");
  });

  socket.on("message", (data) => {
    console.log("Received message:", data);
  });

  socket.on("close", () => {
    console.log("Disconnected from socket");
    connect();
  });

  socket.on("error", (err) => {
    console.error("Socket error:", err);
    socket.close();
  });
};

connect();

附：浏览器中成功连接的请求头截图

可能的解决方法 #

1. 模拟浏览器请求头 #

很多WebSocket服务端会校验请求头，尤其是User-Agent、Origin等字段，Node.js默认请求头和浏览器差异大，可能导致服务端拒绝连接。创建WebSocket实例时手动添加匹配浏览器的请求头：

const socket = new WebSocket(socketUrl, {
  headers: {
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
    'Origin': 'https://xxx.xxx.com', // 替换为浏览器请求头中的Origin值
    // 补充截图中显示的其他必要请求头
  }
});

2. 修正URL格式 #

浏览器会自动处理URL转义字符，Node.js中需确保URL参数用&而非&，避免格式错误：

// 直接使用&分隔参数，无需转义
const socketUrl = 'wss://xxx.xxx.com/public/time/player/test/xxx/socket?messageFormat=json&SESSIONID=xxx&instance=xxx&client_version=xxx';

3. 排查网络/代理问题 #

Node.js可能受系统代理或环境变量HTTP_PROXY/HTTPS_PROXY影响，可尝试关闭代理，或通过代理Agent连接：

npm install https-proxy-agent

const HttpsProxyAgent = require('https-proxy-agent');
const agent = new HttpsProxyAgent('http://your-proxy-address:port');
const socket = new WebSocket(socketUrl, { agent });

4. 开启调试日志定位问题 #

开启ws包的调试模式，查看连接过程中的详细错误信息：

process.env.DEBUG = 'ws:*'; // 开启调试日志
const WebSocket = require("ws");
// 后续代码不变

5. 尝试兼容型WebSocket库 #

使用isomorphic-ws库，它兼容浏览器和Node.js环境，行为更贴近浏览器原生WebSocket：

npm install isomorphic-ws

const WebSocket = require('isomorphic-ws');
// 后续代码可复用浏览器端逻辑

内容的提问来源于stack exchange，提问作者Red Killer