最近消息与断线补取

保存房间最近消息,在重新加入后自动查询,并按消息 ID 避免重复显示。

🎯 引言

用户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 对象推送到房间。

这里使用进程内存,服务重启后记录清空。超过最近 20 条的消息也会被移除,所以本例只能补取仍在这个范围内的内容。

🛠 提供历史查询事件

在同一个 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后,每条记录仍应只打印一次。验证后恢复为一次调用。


🎉 客户端现在能在加入房间后补取最近记录,并避免同一条消息重复显示。