群里有人问:“刚才发的地址看到了吗?”
你往上翻,没有。新的消息却能正常收到,顶部也没有“连接中”的提示。退出重进,那条地址又出现了。
这种问题很容易被归成“弱网偶现”。但只要把连接状态和消息记录分别查一下,通常就能把问题缩小:新连接已经可用,断开期间的内容却没有补齐。
连接回来了,消息记录还没接上
假设客户端已经保存了消息 101、102。随后网络中断,服务端生成 103、104。重连完成后,客户端收到新消息 105,页面于是显示 101、102、105。
这个例子里的编号是为解释方便设置的连续序号。真实系统可能用不连续 ID 或不透明游标,不能看到数字不连续就认定丢消息。

图 1|示意:恢复连接后,仍需从已确认的位置补取 103、104,并处理与实时消息 105 的交接。
WebSocket 建立新连接这件事,本身不会替业务保存旧连接没收到的聊天记录。心跳恢复了,也只能说明当前连接还能交换数据。
框架提供的保证也要逐项看。比如 Socket.IO 文档区分了消息顺序与送达保证:默认送达语义是至多一次;服务端到客户端若要补发,需要额外保存事件并跟踪客户端位置。文档给出了唯一 ID、持久化事件和重连携带 offset 的实现方向。这个结论针对其默认模式,不代表所有框架配置都一样。
所以,看到 connected 回调就把页面状态改成“已同步”,通常太早了。
补到哪里,要有一份可靠的记录
一个实用的做法是,让服务端能回答“从这个位置以后,我还缺哪些消息”。客户端保存已确认的同步游标,重连时带回来;服务端从可恢复的历史中补发。
这里的“已确认”需要认真定义。
消息到了内存,还没写入本地库,游标却先推进了。此时进程退出,下次启动会从新游标之后继续拉取,刚才没落盘的消息就被跳过去。如果消息和游标都存本地数据库,应尽量在同一事务里更新。数据已保存而游标没推进,通常还能通过重复拉取、按消息 ID 去重来恢复;反过来就麻烦了。
还要问清楚游标属于哪个范围:某个会话、某个账号,还是整个事件流?切换账号后沿用旧游标,或把一个群的进度用到另一个群,都可能造成很难解释的缺口。
只按本地时间查询“最近一分钟的消息”也不够稳。手机时钟可能不准,多条消息可能有相同时间戳,边界处还容易重叠或遗漏。排序和翻页依据应由服务端给出明确规则。
补历史的时候,新消息还在来
补完 103、104 的同时,105 可能已经通过实时连接到达。客户端不能把“拉到历史”和“收到新消息”当成两套互不相干的追加逻辑,否则修好漏消息后,又会出现重复气泡。
可以约定一个同步边界:服务端返回本轮补齐到哪个位置,之后的事件再接入实时流;也可以让两路数据适当重叠,由客户端按稳定消息 ID 合并。无论采用哪种方案,协议都要说明交接时刻发生的新事件如何处理。
消息撤回、编辑也需要进入这套规则。只补“新增消息”,断线期间发生的撤回就可能一直不生效。
历史保留时间同样有限。客户端离线太久,游标已经失效,服务端应明确返回需要重新同步。页面可以提示正在恢复记录,或者按业务规则展示可获得的历史范围。悄悄跳到最新位置,却继续显示“已同步”,会让用户误以为记录完整。
在弱网里,把缺口留出来
准备两个测试客户端 A、B,以及一组可核对的测试消息。A 正常接收几条后,限制 A 的网络;B 继续发送。恢复 A,再检查本地库和页面最终留下的消息集合。
我们开发的「弱网管家」可以在 Android 手机上选择待测应用,再切换弱网模板。用它测试这一段时,我会先明确选中客户端 A,避免把同机的其他辅助应用一起纳入测试。首页有“100% 丢包”等模板,但软件丢包并不等于系统真的断开 Wi-Fi。

图 2|Pixel 6 首页截图。截图中尚未选择测试应用,也未启动测试。
丢包持续多久,要参考实际心跳和断连判定。一次很短的中断可能只触发 TCP 重传,连接根本没断,这轮就不能算重连用例。先从客户端日志确认断连、重连和订阅恢复的时刻,再看缺失的业务消息。
悬浮窗便于在待测应用上方切换模板,抓包和报告则可辅助保留网络过程。以下是对应的设置入口,使用权限以当前版本和账号权益为准。

图 3|Pixel 6 设置页。普通 WSS 流量经过加密,PCAP 不会直接告诉你哪条聊天消息已落库。
下面这几项适合放进回归清单。
| 场景 | 通过时应看到什么 |
|---|---|
| 断线期间新增消息 | 恢复后补齐本账号有权读取的消息 |
| 补历史期间继续发消息 | 边界处无遗漏,重复数据能合并 |
| 收到消息后、保存前结束进程 | 再次启动后仍能补回,游标没有提前越过 |
| 离线超过历史保留窗口 | 明确进入重新同步流程,或说明可恢复范围 |
| 断线期间有撤回或编辑 | 最终显示与服务端约定的状态一致 |
这些是建议用例,本文截图仅展示工具入口,未执行上述聊天业务实验。
回归时可以把两份列表导出来:服务端本轮应交付的消息 ID,以及客户端最终保存的 ID。逐条对齐之后,少了哪条、哪条重复、撤回有没有生效,都能查清楚。再打开页面确认那条地址确实出现了,这一轮才算测完。
本文深入分析WebSocket/TCP重连后历史消息缺失的根本原因,指出连接恢复不等于消息同步完成。重点探讨游标管理、本地持久化与服务端补发机制的协同设计,强调消息ID去重、同步边界定义、撤回/编辑一致性及弱网测试方法。指出常见误区如过早标记“已同步”、游标跨会话复用、仅依赖本地时间戳等,并给出基于事务一致性和服务端权威排序的可靠解决方案。
1951

被折叠的 条评论
为什么被折叠?



