计算机网络 / 系统课时
用 Node.js 启动 WebSocket 服务
用 Node.js 启动 WebSocket 服务
这一节会用 Node.js 和 ws 搭出一个最小可运行的回显服务:浏览器建立连接后发送一条文本消息,服务端接收并原样返回。完成后你能从终端和浏览器控制台同时确认连接、收发与关闭行为。
学习目标
- 安装
ws并启动一个监听 WebSocket 连接的 Node.js 服务 - 处理连接、消息、错误和关闭事件,并完成消息回传
- 使用浏览器原生
WebSocket对象验证端到端通信
准备项目
先在一个空目录中初始化 Node.js 项目并安装 ws。ws 用于 Node.js 侧的 WebSocket 客户端与服务端实现;浏览器侧应直接使用浏览器原生 WebSocket 对象。([GitHub][1])
npm init -y
npm install ws预期结果
npm 命令正常结束,package.json 的 dependencies 中包含 ws。安装日志中的包数量和版本号会随时间变化,只要没有出现安装错误即可继续。
编写最小回显服务
新建 server.js,使用固定教学端口 8080。收到文本或二进制消息后,服务端把同一份数据发回客户端;错误事件单独监听,避免连接错误变成未处理异常。
const { WebSocketServer } = require('ws');
const wss = new WebSocketServer({ port: 8080 });
wss.on('connection', (socket, request) => {
const remoteAddress = request.socket.remoteAddress || '<unknown>';
console.log(`client connected: ${remoteAddress}`);
// 连接级错误必须显式处理,便于定位异常断开。
socket.on('error', (error) => {
console.error('socket error:', error.message);
});
socket.on('message', (data, isBinary) => {
const logValue = isBinary ? '<binary>' : data.toString();
console.log(`received: ${logValue}`);
// 保留原始数据和消息类型,构成最小 echo 行为。
socket.send(data, { binary: isBinary });
});
socket.on('close', () => {
console.log('client disconnected');
});
});
wss.on('listening', () => {
console.log('WebSocket server listening on ws://localhost:8080');
});
wss.on('error', (error) => {
console.error('server error:', error.message);
});这段代码的核心只有两层事件:WebSocketServer 负责接受连接,每个 socket 负责处理该连接上的消息。真实项目通常会在消息处理前增加鉴权、协议解析和参数校验,但首个可运行版本先把通信链路跑通。
启动并验证消息回传
在项目目录启动服务:
node server.js预期输出
WebSocket server listening on ws://localhost:8080保持终端运行,然后打开任意浏览器页面的开发者工具控制台,执行下面的浏览器端代码:
const socket = new WebSocket('ws://localhost:8080');
socket.addEventListener('open', () => {
socket.send('hello websocket');
});
socket.addEventListener('message', (event) => {
console.log('echo:', event.data);
});预期输出
echo: hello websocket服务端终端同时会出现类似结果,其中客户端地址的实际值可能不同:
client connected: <IP>
received: hello websocket如果再在浏览器控制台执行 socket.close(),服务端应打印 client disconnected。到这里,连接建立、客户端发送、服务端接收、服务端回传四个关键环节已经全部验证。
典型失败怎么定位
出现 EADDRINUSE 时,说明 8080 已被其他进程占用,可以关闭占用进程,或把服务端和浏览器端地址一起改成另一个端口。若浏览器立即报连接失败,先确认 node server.js 仍在运行,再核对协议、主机名和端口是否一致。
若页面本身通过 HTTPS 加载,生产环境通常应使用 wss://,并由 HTTPS 服务或反向代理终止 TLS;不要把本地的 ws://localhost:8080 配置直接照搬到公网。最小回显服务只用于验证链路,真正业务还应继续补上鉴权、消息格式校验、心跳与重连策略。