
Hello,我是小兔大白糖。 群聊里踢人、改名、入群那条灰色系统消息,看起来只是一句字符串——但操作人想看到「You removed …」,被踢的人想看到「… removed you」,旁观者又是第三套说法。若写入时就拼死一条 content 落库,这三类人永远同屏同句。写成这篇,给要做 IM 系统消息选型、或正在排查「列表里 You 文案不对」的后端同学。
估计阅读时间:8 分钟
先给结论:别在热路径上为文案查用户库
系统消息(system message)要解决的不是「存一句话」,而是 同一事件、不同查看者(viewer)看到不同人称文案。业界常见两条路:写入时就把各视角文案算好存进去,或只存结构化事件、读取时再套模板。无论选哪条,有一条硬底线:消息列表 / 实时扇出的读路径上,视角选择必须是纯函数——输入已有字段,输出一条字符串;禁止为渲染再查用户表、缓存或 RPC。展示名应在写入时冻结进文案或 params,而不是每次刷列表再拉资料。
心智模型:法庭笔录 vs 当事人回执
可以把持久化层想成 法庭笔录:只记「发生了什么」——事件类型、操作人(actor)、对象(target)、参数(改了名还是头像)。
展示层则是 当事人回执:给原告、被告、旁听各写一封称呼不同的信。
这个比喻能帮你记住「视角文案」和「事件事实」要分开;它 解释不了 多语言里词形变化、复数、敬语等全部复杂度,那些要单独做 i18n 设计。
精确定义与边界
| 概念 | 含义 |
|---|---|
| 系统消息 | 由 IM 服务端生成、非普通用户 UGC 的会话内通知(入群、踢人、群资料变更等)。 |
| 查看者相对文案(viewer-relative copy) | 同一条逻辑消息,根据 viewer_id 与 actor_id / target_ids 的关系,展示不同字符串(含 You / 被 You 等语义)。 |
| 兼容字段 | 老客户端只认单个 content 时,约定该字段 固定存旁观者视角(other),避免旧端看到操作人专属的 You 却误以为是「全局真相」。 |
| 读热路径 | 拉历史、游标分页、WebSocket 扇出等高频路径;这里只做 O(1) 字段选择或轻量模板,不做 I/O。 |
边界:本文讨论服务端统一文案 + 多端展示;若完全客户端自渲染(模式 D),审核与文案一致性是另一套问题。
业界四种模式怎么选
| 模式 | 做法 | 优点 | 代价 |
|---|---|---|---|
| A. 单字符串落库 | 事件发生时拼一句中英文,写入 content | 实现最快;读路径零逻辑 | 无 You 语义;改文案往往要迁历史或接受新旧混杂 |
| B. 写入时三份文案 | 持久化 actor_copy、target_copy、other_copy;公开 content = other | 读路径 O(1) 按 viewer 选字段;不依赖模板引擎 | 存约三倍字符串;文案改版仍难批量改旧消息 |
| C. 结构化事件 + 读时模板 | 存 event_type、actor、targets、params;客户端或服务端渲染 | 文案可演进;天然利于 i18n | 读路径要渲染逻辑;旧客户端需兼容层(常仍暴露 other 字符串) |
| D. 只推事件、客户端全渲染 | 服务端几乎不存展示文案 | 端上极灵活 | 多端文案易漂移;合规与审核链更难统一 |
教学基线(分享时可复述):
- 要 服务端统一文案,且 老客户端暂不改、读路径要极简 → 倾向 B(或把 B 当作迁往 C 的过渡:兼容字段仍是 other)。
- 要 多语言、文案常改、愿意在读路径加渲染 → C;兼容层仍可只暴露 other 字符串给旧端。
- A 适合 MVP 或纯旁观者文案足够的产品;D 适合强端能力、能扛文案治理成本的团队。
六条硬规则(去掉比喻也能用)
- 视角选择是纯函数:
(viewer_id, actor_id, target_ids, 已持久化的各份 copy 或 params)→ 一条字符串;列表 QPS 再高也不追加用户库查询。 - 角色优先级写死:常见顺序
actor > target > other;同一人兼多角时按优先级,避免同屏闪烁两套文案。 - 公开兼容字段 = other:旧客户端只读
content时,看到的是旁观者文案,语义正确。 - 展示名在写入时冻结:nickname / 显示名进文案或 params(或连接期已缓存的快照);typing、拉列表禁止「现查现拼」。
- 事件粒度按用户可感知字段拆:改名、改头像、改描述分条;无变更不发;同请求多字段变更用稳定顺序,方便产品与审计解释。
- 实时扇出浅拷贝:按接收人改写 content 时,禁止改共享 message 指针上的全局对象——否则后到的接收人会看到前一个 viewer 的 You。
写入与读取长什么样(示意)
写入:事件到达 → 用当时冻结的展示名生成 actor / target / other 三份 copy → 持久化 { content = other_copy, detail 可选 }。
读取 / 扇出:pick(viewer) — viewer 是 actor → actor_copy;viewer 在 targets 里 → target_copy;否则 → other_copy 或兼容 content。
不必上代码墙;记住 Write 算文案、Read 只选字段 即可。
常见事件的三视角示例(教学示意)
| 场景 | actor 视角 | target 视角 | other(兼容 content) |
|---|---|---|---|
| 移除成员 | You removed T | A removed you | A removed T |
| 加入 | You joined | (常与 actor 相同) | A joined |
| 改名 | You changed the name to … | 常与 other 相同 | A changed the name to … |
反模式:这四类坑最常见
读列表时现查用户表拼 You
列表 QPS × 每条消息一次查询,延迟和 DB 压力线性涨;且展示名与写入时不一致时,历史消息会「变脸」。
三份文案改同一个共享 message 再广播
扇出顺序下,后一个订阅者可能读到上一个 viewer 改过的 content——属于并发与对象所有权问题,不是产品规则能兜住的。
用「updated the group」吞掉所有字段变更
实现省事,但产品无法解释「到底改了名还是头像」;排查客诉只能猜。
从 Sender=system 推断推送标题里的「发起人」
通道元数据(系统通道)和展示名职责混在一起,容易出现通知里显示 system 误导用户——应走专门展示名链路,别在推送层偷推断。
选型清单(可直接转给同事)
| 你的约束 | 更合适的方向 | 要接受的副作用 |
|---|---|---|
| 必须要 You / 被 You,读路径极简,客户端短期不改 | B:写入三份 + 读时选择 | 存储变大;改全局文案难覆盖历史 |
| 多语言、运营常改文案、能维护模板与版本 | C:结构化事件 + 模板 | 读路径复杂度上升;旧端要靠 other 兼容 |
| 只做 MVP、旁观者一句就够 | A:单字符串 | 以后上 You 语义可能要迁数据或双轨展示 |
| 历史消息没有 detail | 回退旧 content | 不强行回填,避免伪造视角 |
小结:三句话带走
- 系统消息的本质是 事件事实 + 查看者相对文案,不是一条写死的字符串。
- 读路径禁止为文案做 I/O;展示名写入时冻结,视角用纯函数选 actor / target / other。
- 要兼容旧客户端就把
content钉死在 other;要强 i18n 再上结构化模板,B 往往是到 C 的便宜过渡。
如果你正在对比「落库三份字符串」和「只存 event_type + params」,可以先在纸面上画一次 Write / Read 伪流程,再对照上表看团队更能接受 存储与改历史 还是 渲染与兼容层 的代价——比先写一版单字符串再返工便宜得多。