IM 系统消息:别存死一条字符串,按查看者选 You 文案

IM 系统消息:别存死一条字符串,按查看者选 You 文案

Hello,我是小兔大白糖。 群聊里踢人、改名、入群那条灰色系统消息,看起来只是一句字符串——但操作人想看到「You removed …」,被踢的人想看到「… removed you」,旁观者又是第三套说法。若写入时就拼死一条 content 落库,这三类人永远同屏同句。写成这篇,给要做 IM 系统消息选型、或正在排查「列表里 You 文案不对」的后端同学。

估计阅读时间:8 分钟


先给结论:别在热路径上为文案查用户库

系统消息(system message)要解决的不是「存一句话」,而是 同一事件、不同查看者(viewer)看到不同人称文案。业界常见两条路:写入时就把各视角文案算好存进去,或只存结构化事件、读取时再套模板。无论选哪条,有一条硬底线:消息列表 / 实时扇出的读路径上,视角选择必须是纯函数——输入已有字段,输出一条字符串;禁止为渲染再查用户表、缓存或 RPC。展示名应在写入时冻结进文案或 params,而不是每次刷列表再拉资料。


心智模型:法庭笔录 vs 当事人回执

可以把持久化层想成 法庭笔录:只记「发生了什么」——事件类型、操作人(actor)、对象(target)、参数(改了名还是头像)。
展示层则是 当事人回执:给原告、被告、旁听各写一封称呼不同的信。

单字符串落库对比按查看者三视角文案
单字符串落库对比按查看者三视角文案 · 点击查看 SVG 原图

这个比喻能帮你记住「视角文案」和「事件事实」要分开;它 解释不了 多语言里词形变化、复数、敬语等全部复杂度,那些要单独做 i18n 设计。


精确定义与边界

概念含义
系统消息由 IM 服务端生成、非普通用户 UGC 的会话内通知(入群、踢人、群资料变更等)。
查看者相对文案(viewer-relative copy)同一条逻辑消息,根据 viewer_id 与 actor_id / target_ids 的关系,展示不同字符串(含 You / 被 You 等语义)。
兼容字段老客户端只认单个 content 时,约定该字段 固定存旁观者视角(other),避免旧端看到操作人专属的 You 却误以为是「全局真相」。
读热路径拉历史、游标分页、WebSocket 扇出等高频路径;这里只做 O(1) 字段选择或轻量模板,不做 I/O。

边界:本文讨论服务端统一文案 + 多端展示;若完全客户端自渲染(模式 D),审核与文案一致性是另一套问题。


业界四种模式怎么选

系统消息文案四种策略对照
系统消息文案四种策略对照 · 点击查看 SVG 原图
模式做法优点代价
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 适合强端能力、能扛文案治理成本的团队。

六条硬规则(去掉比喻也能用)

  1. 视角选择是纯函数:(viewer_id, actor_id, target_ids, 已持久化的各份 copy 或 params) → 一条字符串;列表 QPS 再高也不追加用户库查询。
  2. 角色优先级写死:常见顺序 actor > target > other;同一人兼多角时按优先级,避免同屏闪烁两套文案。
  3. 公开兼容字段 = other:旧客户端只读 content 时,看到的是旁观者文案,语义正确。
  4. 展示名在写入时冻结:nickname / 显示名进文案或 params(或连接期已缓存的快照);typing、拉列表禁止「现查现拼」。
  5. 事件粒度按用户可感知字段拆:改名、改头像、改描述分条;无变更不发;同请求多字段变更用稳定顺序,方便产品与审计解释。
  6. 实时扇出浅拷贝:按接收人改写 content 时,禁止改共享 message 指针上的全局对象——否则后到的接收人会看到前一个 viewer 的 You。

写入与读取长什么样(示意)

读路径纯函数按查看者选择文案
读路径纯函数按查看者选择文案 · 点击查看 SVG 原图

写入:事件到达 → 用当时冻结的展示名生成 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 TA removed youA 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不强行回填,避免伪造视角

小结:三句话带走

  1. 系统消息的本质是 事件事实 + 查看者相对文案,不是一条写死的字符串。
  2. 读路径禁止为文案做 I/O;展示名写入时冻结,视角用纯函数选 actor / target / other。
  3. 要兼容旧客户端就把 content 钉死在 other;要强 i18n 再上结构化模板,B 往往是到 C 的便宜过渡。

如果你正在对比「落库三份字符串」和「只存 event_type + params」,可以先在纸面上画一次 Write / Read 伪流程,再对照上表看团队更能接受 存储与改历史 还是 渲染与兼容层 的代价——比先写一版单字符串再返工便宜得多。