Node.js使用ws库启动WebSocket服务运行后自动终止，是什么问题？

数据老陈

2026-9-29

问题根因分析

Node.js 进程自动退出的核心逻辑是：当事件循环中没有需要处理的活跃异步任务时，进程会自动终止。

你第一个版本的代码直接退出，本质是 ws 库的 Server 实例绑定端口是异步操作：主线程同步代码执行完 wss.on("connection", ...) 的事件绑定逻辑时，端口绑定的异步任务还没被注册到事件循环的活跃任务队列中，Node.js 判定没有待执行任务，就直接退出了。

你添加 console.log("Hello") 后进程不退出，并不是 console.log 本身有特殊作用，只是这句同步输出让主线程多运行了几毫秒，刚好等到了端口绑定的异步任务注册完成，事件循环检测到有活跃的 TCP 监听任务，就会保持进程持续运行，属于巧合性的修复。

正确排查&修复方案

1. 必加事件监听，明确服务状态

不要靠随机的时间差保证服务启动，主动添加错误监听、启动成功监听，就能直接定位问题：

const WebSocket = require("ws");

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

// 新增：服务启动成功监听
wss.on("listening", () => {
  console.log("WebSocket 服务已启动，监听端口 8082");
});

// 新增：服务错误监听，比如端口被占用等问题都会在这里抛出
wss.on("error", (err) => {
  console.error("服务启动失败：", err.message);
});

wss.on("connection", ws => {
  console.log("New client connected");

  ws.on("close", () => {
    console.log("Client has disconnected!")
  })
})

如果是端口被占用、权限不足等常见启动问题，error 事件会直接抛出具体原因。