如何创建安全Node.js WebSocket客户端？解决无法验证首个证书问题

算力阿峰

2026-8-5

解决WebSocket-Node客户端连接WSS时的证书验证错误

问题原因

你遇到的Error: unable to verify the first certificate错误，本质是因为你的WebSocket服务器使用的是自签名证书：

浏览器端能正常连接，是因为你可能已经手动信任了该证书（比如访问HTTPS时点击了"继续访问"）
Node.js的TLS模块默认只信任CA机构签发的正规证书，对自签名证书会直接拒绝验证

另外你的客户端代码存在两个小问题：

WebSocket-Node客户端的TLS配置需要放在tlsOptions子对象中，而非直接平级传入
你的服务器并未开启双向TLS认证（不需要客户端提供证书），所以客户端无需传入key和cert参数

解决方案

1. 开发环境临时方案（不推荐生产使用）

如果只是本地开发测试，可以临时关闭证书验证，快速绕过错误：

var WebSocketClient = require("websocket").client;

var client = new WebSocketClient({
  tlsOptions: {
    // 禁用证书验证，仅开发环境临时使用
    rejectUnauthorized: false
  }
});

client.connect("wss://localhost:8080/", "");

注意：这个选项会关闭所有证书安全性校验，绝对不能在生产环境使用。

2. 开发/测试环境正规方案（推荐）

将服务器的自签名证书添加到客户端的信任列表中，既保持安全性，又能正常连接：

var WebSocketClient = require("websocket").client;
var fs = require("fs");

var client = new WebSocketClient({
  tlsOptions: {
    // 读取服务器的证书文件，将其作为信任的CA证书
    ca: fs.readFileSync("./server.crt"),
    // 保持证书验证开启（默认值，可省略）
    rejectUnauthorized: true
  }
});

client.connect("wss://localhost:8080/", "");