← 返回文章列表

Blog / Deer404

聊天消息如何在多端保持一致

Jul 3·11 min
AI 生成的摘要
以一套支持群聊与群下私聊的聊天系统为例,从一次回执丢失的发送说起,解释浏览器和移动端怎样确认消息、补齐历史并同步阅读进度。

这篇文章记录的是一套供成员与工作人员沟通的聊天系统。它有浏览器工作台和 Flutter 移动端,支持群聊,也支持群下私聊:成员可以从某个群进入与工作人员的单独会话。同一个成员从两个群发起的私聊,会保留各自的消息和阅读进度。

聊天功能需要处理几个很日常的操作:发消息、翻历史、在另一台设备上接着读,以及断网后重新连接。以浏览器端为例,实时消息通过 XMPP 长连接收发,已经保存的消息可以通过 HTTP 接口查询。本地则用 IndexedDB 保存拿到的记录,页面从中取出一段来展示。因此,一条消息可能先从长连接到达,也可能稍后才从历史接口补回来。

这套分工在网络正常时不太显眼,断线以后就会影响用户看到的结果。假设工作人员在电脑上发出一条消息,服务器已经保存,确认回执却没能回来。电脑等了一阵显示发送失败,手机打开同一会话时,却从历史里读到了这条消息。

要让电脑和手机重新显示一致的结果,首先得认出它们说的是同一条消息,再分别校正发送状态、补齐历史和合并阅读进度。消息的 ID、服务端记录与阅读光标,便是在这些步骤里各自发挥作用的。

本地记录与消息身份

浏览器端会先把消息存到本地,标为 SENDING,再交给长连接发送。用户点击后马上能在列表里看到它,不必等网络往返完成。气泡出现,只说明客户端已经接受了这次输入,旁边的发送状态还要继续等结果。

消息在写入本地之前,就需要生成 ID。后面收到回执、查询发送结果、拉取历史,都需要找到这条本地记录。浏览器端把同一个 ID 写进 XMPP 消息的 id 和 origin-id 字段,让不同入口返回的数据能够对应起来。

这也是为什么不能按正文去重。用户连续发两次“好的”,可以是两条正常消息;因为没等到确认而重发一次,才需要关联到原来的发送。区分它们的依据是消息身份,单看文字没有办法判断。

在历史合并中,浏览器端优先使用 origin_id,没有时退回 id 去重。不过,客户端能够认出重复记录,还不等于服务端会拒绝重复创建。重试时既要核对原消息使用的 ID,也要有服务端配合判重。当前历史合并主要处理重复出现的消息,先遇到的记录会被保留;它没有顺便解决编辑、撤回等内容变化该如何覆盖的问题。

发送确认与结果未知

浏览器在长连接上收到发送确认时,会把消息 ID 暂存在一个列表中。这种确认回执在代码里称为 ACK,发送流程可以检查自己的 ID 是否已经出现。正常情况下,检查到回执就可以结束等待。

但开头的情况恰好发生在服务器保存之后:回执没有送回来,继续等同一条连接未必能得到答案。这个系统还提供了按消息 ID 查询记录是否存在的 HTTP 接口,于是浏览器可以换一个途径确认。它不用重新拉取整个会话,只需要查刚才那条消息。

具体执行时,会先等一小段时间,查看 ACK 列表。若 ID 已经在里面,就不必再发请求;没有才调用 HTTP 接口。查询确认消息存在,同样按已发送处理,并把 ID 补进确认列表。两个途径围绕同一个 ID 工作,查询结果不会另建一条聊天记录。

当前实现会重复几轮这样的检查,等待间隔如下,单位是毫秒:

snippet
typescript
const checkIntervals = [300, 300, 500, 1000, 2000, 4000, 6000, 10000]

每轮都先等待,再检查回执和查询结果,请求本身也要花时间。最后的 10000 只是那一轮等待十秒,整个过程会更长。所有轮次结束后还会做一次最终查询。确认列表最多保留 100 个 ID,供近期发送检查使用,聊天历史仍由本地数据库和服务端保存。

如果 ACK 和 HTTP 查询一直都没有确认下来,当前代码会把消息标成 FAILED。这里仍有一个表达上的缺口:服务器明确拒收,与客户端断网后无法查明结果,都可能表现为发送失败。对开头那条实际上已经保存的消息,客户端掌握的事实只是“还没确认到”。

因此,后来从历史中取回这条消息时,需要按原 ID 找回本地记录,重新处理它的状态。若以后增加“未确认”状态,也要一起调整这段合并和重试流程。只换掉失败图标,无法避免重复发送。

还有一种确认不能混进来:对方是否已读。ACK 或 HTTP 查到记录,最多让这套发送流程确认服务端存在消息,对方设备有没有展示、用户有没有打开会话,要由阅读状态另行表达。

离线历史的补偿

刚才的例子里,电脑缺的是发送确认。若它断网期间又有别人发来消息,还会缺少整段聊天记录。恢复 XMPP 连接以后,新消息能继续到达,但离线时漏掉的记录仍要从 HTTP 历史接口取回。

最直接的做法是把整个会话重新下载一次。消息少时可以接受,历史越多,重复传输越多。本地已经有大部分记录时,更合适的办法是从已知位置继续查询,并允许边界附近有少量重叠,回来后按消息 ID 合并。

浏览器端的历史接口支持从一条消息向前或向后翻页。同步会一页页推进,遇到空页、未满页或游标不再变化时停止,并设有最多 100 页的保护。这个上限防止一次同步无限进行;如果停在上限处,不能据此认为所有历史都已补齐。

这里还要用到开头提过的群下私聊。假设同一成员分别从群甲和群乙与工作人员沟通,只按聊天对象查询,就可能把两段业务下的记录混在一起。浏览器端因此用会话地址和来源群共同确定查询范围,来源群就是这段私聊从哪个群发起。后面的阅读光标和未读统计,也需要沿用这个范围。

移动端另一个需要处理的情况是切账号。账号 A 的历史请求还没回来,用户已经退出并登录 B,旧响应仍然可能成功返回。Flutter 端会在同步开始时记住账号和本轮登录的代次,在多个异步步骤返回后重新检查。退出后再登录同一个账号,代次也会变化,旧任务不能继续把结果写入新一轮会话。

同一会话范围的同步还会排队,避免同时修改同一段数据。排队与账号检查分别处理并发写入和旧结果失效,都不代表已经取消了网络请求。具体流程放在离线消息补偿笔记中。

跨设备的阅读进度

回到开头的场景。手机已经从历史中读到那条消息,用户也打开了会话。此时需要同步的是阅读进度。如果只传一个“未读数减一”,电脑可能还没补到同样的消息,或者重复收到这次更新,很难知道该把哪条标为已读。

这套聊天系统用阅读光标记录读到了哪里。光标带有阅读时间和相关消息 ID,各端据此更新本地消息状态,再计算未读数。一次更新描述的是会话中的阅读位置,而非对计数器执行一次加减。

两台设备上传的进度可能乱序到达。例如手机已经读到较晚的位置,电脑随后才发来一份较早记录,直接用后到的结果覆盖,就会把进度拉回去。现有合并规则会比较光标时间:新时间更晚才推进,旧时间更早就保留当前值;时间相同时,只在当前缺少消息 ID 的情况下补上。

这条规则依赖时间能够比较,没有把 ID 的字典序当作消息顺序。相同时间戳下的精确边界、主动重置阅读位置等需求,还需要另行约定。群下私聊也不能省略来源群,否则读完群甲的对话,可能清掉群乙的未读。

浏览器里还要同步更新数据库和当前页面使用的内存状态。只写数据库,已经打开的页面可能继续显示旧角标;只改内存,刷新页面又会读回旧值。这部分的处理见阅读光标与范围和未读刷新。

历史同步与阅读窗口

发送和阅读状态都校正后,聊天页面还要照顾用户正在查看的位置。用户可能刚从搜索结果跳到几个月前的一条消息,正在看那时的上下文。浏览器数据库里已经有最新记录,页面却只显示旧历史中的一段,这时并不需要把用户拉回最新消息。

浏览器端因此把本地存储、同步进度和展示窗口分别维护。阅读光标记录用户读到哪里,同步位置记录还要补哪些数据,展示窗口则决定当前列表放哪一段。搜索负责找到目标附近的记录并重建窗口,向上或向下翻页再从窗口边缘继续取。不能把窗口末尾直接当成同步起点,否则用户跳到旧消息时,后台也会跟着从很早的位置重新拉数据。

现有分页流程会先读本地,再等待远端校准完成或失败,最后更新窗口;它还不是“本地先显示、后台再补齐”的流程。搜索定位目前也只在本地查目标附近的上下文,本地没有时,不能自动去服务端补。完整的查询与展示关系见分页与搜索笔记。

这样再看开头那次断线,就能分别判断几个问题:电脑上的发送失败,需要回执或查询结果来校正;断线漏掉的消息,需要历史补偿;手机读过的位置,需要合并阅读光标;电脑还在查看旧消息,则可能只是用户没有离开当前窗口。它们最终都影响同一个聊天页面,但不能靠一次“连接成功”,或者一个“同步完成”标记一起更新。

最后修改时间: Nov 5