断线重连与状态提示
🎯 引言
用户A正在接收 room1 的消息,服务器突然重启。客户端需要告诉用户连接已经中断,并在服务恢复后重新加入房间。本篇沿用认证章节的服务端,通过一次停止、重启实验验证这个过程。
🧱 自动重连后还需要做什么
网络中断或服务意外停止时,Socket.IO 客户端默认会尝试重新连接。连接重新成功后,还会触发一次客户端的 connect 事件。
服务进程重启会清空原来的连接和房间成员记录。因此客户端连接成功后,还需要再次请求加入 room1,等加入确认后才能继续接收该房间的消息。
上一篇已经把加入操作写在 connect 回调里,这部分可以用于重连。不过,之前为了演示,还在加入成功后自动发送了一句“你好”。如果一直保留它,每次重连都会再次发送这句话。本篇让用户A只恢复订阅,由用户B发送消息来验证接收。
| 客户端事件 | 本次实验中的含义 |
|---|---|
| connect | 初次连接或重新连接成功,接着请求加入房间 |
| disconnect | 原连接已断开 |
| connect_error | 一次连接尝试失败 |
🛠 显示状态并重新加入房间
把用户A的 client.mjs 替换为下面的代码。服务端使用上一篇的认证和房间处理代码。
import { io } from 'socket.io-client';
const socket = io('http://localhost:3000', {
auth: { token: 'demo-token-a' }
});
const room = 'room1';
socket.on('connect', () => {
console.log('连接成功,正在加入房间');
socket.timeout(3000).emit('room:join', room, (error, result) => {
if (error) {
console.log('加入房间超时');
return;
}
console.log(result.ok ? `已加入 ${result.room}` : result.error);
});
});
socket.on('disconnect', (reason) => {
console.log('连接已断开', reason);
});
socket.on('connect_error', (error) => {
console.log('连接失败', error.message);
});
socket.on('chat:message', (message) => {
console.log(`[用户${message.senderId}] ${message.text}`);
});
connect 每次成功连接都会执行,因此把重新加入的操作放在这里。chat:message 在外面注册一次,连接恢复后仍然有效。若把它也放进 connect,每次重连都会增加一个监听,可能让同一条消息打印多次。
停止服务,观察输出
先运行服务端,再运行用户A客户端。保持客户端运行,在服务端终端按 Ctrl+C,稍等后重新执行 node server.mjs。
| 操作 | 用户A的预期输出 |
|---|---|
| 首次启动 | 连接成功,正在加入房间 → 已加入 room1 |
| 停止服务 | 连接已断开,以及断开原因 |
| 服务仍未恢复 | 可能多次打印连接失败 |
| 重新启动服务 | 再次显示连接成功 → 已加入 room1 |
等待用户A打印“已加入 room1”,再运行上一篇的用户B客户端:token 为 demo-token-b,room 为 room1,加入后自动发送“你好”。用户A应收到一条 [用户B] 你好。
🧰 限制重连次数
默认客户端会持续尝试。若希望尝试几次后停止,可以把创建 socket 的代码替换为下面这段。
const socket = io('http://localhost:3000', {
auth: { token: 'demo-token-a' },
reconnectionDelay: 1000,
reconnectionDelayMax: 5000,
reconnectionAttempts: 5
});
| 选项 | 作用 |
|---|---|
| reconnectionDelay | 初始重试间隔的基准值,单位毫秒 |
| reconnectionDelayMax | 重试间隔的上限,单位毫秒 |
| reconnectionAttempts | 自动重连最多尝试的次数 |
间隔会逐渐增加,并带有随机调整,因此日志不会严格每隔一秒出现一次。达到次数上限仍未成功时,自动重连会停止。客户端配置文档
若要显示“已经停止重试”,在客户端顶层增加以下监听。
socket.io.on('reconnect_failed', () => {
console.log('重连次数已用完,请检查服务后重新运行客户端');
});
这里的 socket.io 是客户端内部管理连接和重试的对象,重试耗尽事件在它上面监听。完成有限重试实验后,去掉这三个配置项即可恢复默认行为。客户端 API
❓ 知识问答
Q1:为什么主动断开后没有自动重连?
调用 socket.disconnect() 表示主动结束连接,客户端会保持断开,直到再次调用 socket.connect()。无效 token 导致认证拒绝时,也应先修正凭证再重新连接。
Q2:重新加入房间后,会收到离线期间的消息吗?
当前服务只广播给当时在线的房间成员。重新加入可以接收后续消息,之前遗漏的内容需要服务端保存,再由客户端查询补回。
🧪 小练习
连续进行三次服务重启。每次等用户A重新加入 room1,再启动用户B发送“你好”,收到确认后结束用户B进程。用户A每轮应只新增一条消息,检查它是否出现重复监听。
随后启用五次重试上限,停止服务并等待“重连次数已用完”。恢复服务后观察用户A不会自动连上,再重新运行客户端,确认连接和房间加入成功。
🎉 你已经可以验证断线提示、自动重连和房间订阅恢复。
