
Hello,我是小兔大白糖。 产品口里一句「删掉这个聊天」,后端耳里可能是三种完全不同的合同——个人看不见旧消息、双方房间拆掉、还是人走了群还在。写成这篇,给要做 IM 会话生命周期选型调研 的初中级后端同学:不是某仓库会话接口说明书,而是业界常见的作用域心智模型。
说明:字段名(如
cleared_at)与模式 A~F 是教学分析框架,不是某厂官方协议。公开聊天产品在文案上常把「清空 / 删除 / 退出」分开——此处只作行为归纳,不声称内部实现。示例为教学脱敏示意。已读水位与成员关系建模见系列文:已读回执水位、成员嵌入 vs 集合。
估计阅读时间:8 分钟
目录
为什么现在要关心
硬规则一句话:先钉作用域——个人视图、共享房间、成员资格——再谈按钮文案。
现场误伤几乎都长这样:
| 用户口头说 | 常期望 | 若实现错了 |
|---|---|---|
| 「清空聊天」 | 我这边看不到旧消息 | 误删全屋消息;对方也被清 |
| 「删除会话」 | 列表里消失 | 群被整屋删掉;或只是本地藏起来 |
| 「退出群」 | 我走了群还在 | 当成删群;或创建者直接 leave 留下无主群 |
删掉比喻后仍成立的三条硬规则:
- Clear = 个人水线:只改当前成员视角的可见起点;消息正文与其他成员未读不动。
- Delete 房间 = 共享语义:通常仅 1:1 允许「双方列表都消失」;群用 Leave / 解散,不把 Delete 当 Clear。
- Leave / Kick = 成员资格:改的是「还在不在群里」;创建者 leave 前要转让或走解散流程。
问题空间:三个按钮,三种合同
本篇主线是会话生命周期的作用域拆分;已读上报形状与 membership 存法交给系列文。
| 主题 | 本篇是否展开 | 相关阅读 |
|---|---|---|
| 已读水位 vs 消息 ID 列表 | 点到为止(Clear 常与已读同落 membership) | /blog/im_read_receipt_watermark_vs_ids/ |
| 成员嵌入文档 vs 独立集合 | 点到为止(资格变更落在哪一层) | /blog/im_chat_membership_embed_vs_collection/ |
| Clear / Delete / Leave 作用域 | 主线 | — |
| 1:1 删房 vs 群退群 / 解散 | 主线 | — |
能力拆三层,别揉成一个「删除」接口:
| 能力 | 人话 | 代价直觉 |
|---|---|---|
| 个人可见水线(Clear) | 从现在起我不看旧历史 | 写放大小;历史仍占存储;对端无感 |
| 共享房间生命周期(Delete / Dissolve) | 这间房还在不在 | 1:1 可双方失效;群解散影响全员 |
| 成员资格(Leave / Kick) | 人还在不在这屋里 | 权限、转让、无主群风险 |
心智模型:合租客厅
Clear 是你翻自己的日历;Delete 1:1 是拆两人小黑屋;Leave 是你搬走;Kick 是管家请人走;Dissolve 是整套房退租。
| 类比 | 对应概念 | 硬规则直觉 |
|---|---|---|
| 把自己房间日历翻到「今天起」 | Clear(个人水线) | 室友日历不动;客厅里的旧照片还在 |
| 两人专用小黑屋拆了 | Delete 1:1 房间 | 下次再聊是新屋(新房间身份) |
| 你搬走,客厅还在 | Leave | 只失效自己的资格 |
| 管家请某人走 | Kick | 改他人资格,需权限 |
| 整套房退租 | Dissolve | 房间关闭 + 全员资格失效 |
类比局限一句说清:只解释作用域与产品语义;解释不了消息存储引擎选型、已读扇出细节、推送通道——那些见已读文、成员关系文与触达相关文。 日历类比管「我从哪天起看得见」,解释不了合规取证要不要保留原文。
精确定义:作用域与常见模式
先问:这次操作改的是「我的视图」「整间房」还是「谁还在房里」?三者不能共用一个 Delete。
常见模式对比
| 模式 | 作用域 | 数据落点(教学名) | 适用 |
|---|---|---|---|
| A. Clear(个人) | 仅自己 | membership:cleared_at、本地未读归零;历史可仍在库,查询 msg.ts > cleared_at | 1:1 与群都该有 |
| B. Hide / Archive | 仅自己列表 | membership 标志,不改历史可见水线 | 「先不看」 |
| C. Delete 1:1 房间 | 双方共享 | 房间软删 + 双方 membership 失效;再聊开新房 | 仅 1:1 |
| D. Leave | 自己资格 | 删 / 失效自己的 membership;群仍在 | 群 |
| E. Kick | 他人资格 | 管理员移除目标 membership | 群 + 权限 |
| F. Dissolve | 整屋 | 房间关闭 + 全员失效 | 群主 / 管理员 |
教学倾向:产品文案把 A / C / D 分词;实现上 禁止用删消息表冒充 Clear。
Clear 常与已读水线一起落在 membership 上:清完后未读归零,历史拉取从 cleared_at 之后开始——合同仍是个人视图,不是共享房间死亡。
代价先说清:
- Clear 便宜、对端无感,但库里历史还在(存储与合规策略要另订)。
- Delete 1:1 语义清晰,但「再聊」必须开新房,旧房 ID 不宜复活糊弄过去。
- Leave 简单,创建者无转让直接走 → 无主群;Dissolve 影响面最大,文案与权限要配齐。
示意流程与作用域矩阵
伪流程只演示合同顺序;字段名为教学脱敏,非生产 API。
Clear(chat_id, me):
assert member(me)
update membership(me): cleared_at=now, unread=0
// 不碰 messages;不碰其他 membership
Delete_1to1(chat_id, me):
assert type==1:1 && member(me)
soft-delete room; invalidate all memberships
// 再发消息 → 新 room_id
Leave(group_id, me):
assert type==group && not sole-owner-without-transfer
remove membership(me); maybe bump member_count作用域一眼矩阵:
| 操作 | 个人视图 | 共享房间 | 成员资格 |
|---|---|---|---|
| Clear | 改(水线) | 不动 | 仍在 |
| Hide / Archive | 列表藏 | 不动 | 仍在 |
| Delete 1:1 | 双方列表消失 | 软删 / 关闭 | 双方失效 |
| Leave | — | 房间仍在 | 自己失效 |
| Kick | — | 房间仍在 | 目标失效 |
| Dissolve | 全员不可用 | 关闭 | 全员失效 |
反模式
最贵的错:用物理删 messages 冒充 Clear;其次是群上的「删除」语义漂移。
| 反模式 | 为何糟 | 更稳的拆法 |
|---|---|---|
| Clear 物理删 messages | 取证没了;对端同步灾难;多端对不齐 | 只写 membership 水线;历史策略单独订 |
| 群提供 Delete 却做成 Clear(或反过来) | 用户以为「全屋没了」或「只是我看不见」 | 群文案用退出 / 解散;Clear 单独入口 |
| 创建者可 Leave 且无转让 | 无主群:没人能管权限与解散 | leave 前强制转让,或走 Dissolve |
| 客户端「删除」只藏本地 | 服务端仍推旧房未读;换端又冒出来 | 列表 Hide 与服务端合同对齐;真删走 C/D/F |
| 1:1 Delete 复用群 Leave 语义 | 「我走了」≠「两人房拆了」 | 类型分支:1:1 → C;群 → D/E/F |
选型结论
- PRD 用词与 API 一一对应:clear / delete / leave / kick / dissolve,禁止一个「删除」覆盖三种合同。
- Clear 只写 membership 水线;不要用删消息表冒充;接受「库里可能仍有历史」的存储代价。
- Delete 限 1:1 共享房间语义;群生命周期用 leave / kick / dissolve,不复用 1:1 delete。
- 客户端文案避免「删除」一词吞掉 clear:清空聊天 ≠ 删除会话 ≠ 退出群。
- 审计分字段:谁抬了水线、谁拆了房、谁被踢——事后才能回答「到底删了什么」。
系列导航
- 已读别逐条刷:会话水位 vs 消息 ID 列表
- 群成员嵌文档还是独立集合?
- 本文:清空 / 删除 / 退群——个人水线、共享房间与成员资格