断线重连与状态提示

观察意外断线后的自动重连,显示连接状态并重新加入聊天室。

🎯 引言

用户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不会自动连上,再重新运行客户端,确认连接和房间加入成功。


🎉 你已经可以验证断线提示、自动重连和房间订阅恢复。