最近消息与断线补取
🎯 引言
用户A断线时,用户B在 room1 发了两条消息。上一节已经能让A重新连接并加入房间,现在还需要把遗漏的内容取回来。本篇给服务端增加最近消息记录,并让A在加入成功后自动查询。
🧱 先保存消息,再向房间推送
服务端按房间保存最近 20 条消息。每条记录带一个 ID,同一条消息无论通过实时推送还是历史查询返回,都使用这个 ID,客户端据此判断是否已经显示过。
在 server.mjs 顶部导入 randomUUID,在 connection 回调外定义 histories。这样不同客户端访问的是同一份房间记录。
import { randomUUID } from 'node:crypto';
const histories = new Map();
Map 保存“房间名 → 消息数组”的对应关系,randomUUID() 生成消息编号。在 chat:send 的身份、房间和文本检查通过后,把原来的广播语句及成功确认替换为:
const room = socket.data.room;
const message = {
id: randomUUID(),
senderId: socket.data.userId,
text: text.trim()
};
const items = histories.get(room) || [];
items.push(message);
histories.set(room, items.slice(-20));
io.to(room).emit('chat:message', message);
reply({ ok: true, id: message.id });
没有记录时从空数组开始,push 添加新消息,slice(-20) 只保留最后 20 条。保存完成后,再把同一个 message 对象推送到房间。
🛠 提供历史查询事件
在同一个 connection 回调内,增加下面的监听。客户端已经通过认证,查询时继续检查当前房间权限。
socket.on('chat:history', (reply) => {
if (typeof reply !== 'function') {
return;
}
const room = socket.data.room;
if (!room || !canAccess(socket.data.userId, room)) {
reply({ ok: false, error: '请先加入有权访问的房间' });
return;
}
reply({ ok: true, messages: histories.get(room) || [] });
});
服务端从 socket.data.room 确定查询哪个房间。没有记录时返回空数组,客户端仍可按正常查询结果处理。
🔄 加入成功后自动补取
继续修改上一节用户A的 client.mjs。先删除原来的 chat:message 监听,换成下面的代码,让实时消息和历史消息共用一个显示函数。
const seen = new Set();
function showMessage(message) {
if (seen.has(message.id)) {
return;
}
seen.add(message.id);
console.log(`[用户${message.senderId}] ${message.text}`);
}
socket.on('chat:message', showMessage);
Set 用来保存不重复的值。这里先检查消息 ID,已显示过就结束,否则记下 ID 并打印。同一客户端进程重连时,seen 仍然保留;结束进程再启动,seen 会重新变为空集合。
接着在 connect 监听外定义查询函数。
function loadHistory() {
socket.timeout(3000).emit('chat:history', (error, result) => {
if (error) {
console.log('历史查询超时');
return;
}
if (!result.ok) {
console.log(result.error);
return;
}
result.messages.forEach(showMessage);
});
}
最后,把原来的 connect 监听替换为下面这段。初次连接和重连都在加入成功后查询历史。
socket.on('connect', () => {
socket.timeout(3000).emit('room:join', room, (error, result) => {
if (error) {
console.log('加入房间超时');
return;
}
if (!result.ok) {
console.log(result.error);
return;
}
console.log(`已加入 ${result.room}`);
loadHistory();
});
});
先监听实时消息,再加入房间,最后查询历史。这样查询期间到来的新消息也能收到。如果同一条记录同时出现在推送和查询结果中,showMessage 只打印一次。本例按收到的顺序打印,历史与实时消息交叠时,终端输出可能不按原发送时间排序。
❓ 知识问答
Q1:为什么两次发送相同文字,仍然显示两条?
每次提交都会生成新的消息 ID,表示两条独立记录。这里按 ID 避免同一条记录重复显示。若要避免发送重试造成重复保存,还需要为同一次提交设置固定请求 ID,并在服务端去重。
Q2:怎样让服务重启后也能补消息?
把记录保存到数据库,在写入成功后再推送和确认。历史查询从数据库按顺序分页读取,客户端记录读取进度,才能覆盖比最近 20 条更长的断线时间。
🧪 小练习
更新服务端后重启一次,随后整个实验保持服务运行。用户B使用认证章节中“加入 room1 后发送消息”的客户端代码。
| 操作 | 用户A应看到什么 |
|---|---|
| A先启动,B发送“第一条” | 实时收到 [用户B] 第一条 |
| 关闭A,修改B的文字并重新运行,发送“第二条” | A已关闭,无法接收推送 |
| 重新启动A | 加入后自动查到“第一条”和“第二条” |
最后一步重新启动了A进程,本地去重集合已经清空,所以会展示服务端保留的两条记录。要单独验证去重,可以在加入成功回调中连续调用两次 loadHistory,重新运行A后,每条记录仍应只打印一次。验证后恢复为一次调用。
🎉 客户端现在能在加入房间后补取最近记录,并避免同一条消息重复显示。
