设备–用户映射:单活跃不变量、脏数据修复与部分唯一索引

设备–用户映射:单活跃不变量、脏数据修复与部分唯一索引

Hello,我是小兔大白糖。 用户换号登录后,旧账号的推送还在响——联调现场往往先怪推送网关,再怪客户端,最后才发现:同一 device_id 上挂着多条「活跃」映射。写成这篇,给要做 设备–用户映射选型与脏数据治理 的初中级后端同学:业界常见不变量与修复优先级,不是某仓库说明书。

说明:字段名(如 is_active / last_login_at)、伪流程与模式字母均为教学脱敏示意,不是某家产品的内部契约。模式 A~E 是分析框架。指纹解决「是不是同一台」,见 /blog/device_fingerprint_tiers/;在线长连接登记见 /blog/websocket_multi_device_connection_registry/——本文只管 活跃归属谁。

估计阅读时间:9 分钟


目录


为什么现在要关心

硬规则:每设备至多一个活跃用户;写路径保证,库约束兜底,脏数据按确定性优先级收敛到 1。

移动端常见模型是:一台物理设备 ↔ 多个曾登录用户,中间用 mapping(device_id + user_id + 活跃标记)。「活跃」语义一松,现场几乎按同一剧本炸:

你看到的现象常见真相
换号后旧号还收推送同一 device_id 上多条 active=true
会话 / 成员设备列表「同一 token 算两次」查询未默认带活跃过滤
推送网关对同一设备连打 N 条扇出按「用户所有 token」却不过滤活跃映射

业界要钉死的不变量通常是二选一(或组合):

  1. 每设备至多一个活跃用户(谁最后登录谁占用设备)——本文焦点;
  2. 每用户每平台至多一个活跃设备(多端另开维度)——别和 (1) 揉成一个唯一键。

删掉比喻后仍能复述的三条:

  1. 写路径保证不变量:登录 / 绑定成功时,先 demote(降级)该设备上其他 mapping,再置当前活跃。
  2. 历史脏数据按明确优先级收敛到 1,修完再上唯一约束。
  3. 约束与查询对齐:部分唯一索引 + 查询默认带活跃过滤;修复作业与线上写路径用同一套「胜者」规则。

心智模型:工位门禁卡

设备是门禁机;活跃 mapping 是贴在机上的工牌;换人登录 = 撕旧牌再贴新牌;双活 = 两张牌同时贴着 → 门铃(推送)响两次。

类比含义
工位门禁机物理设备(device_id)
当前贴着的工牌活跃 mapping(active=true)
撕旧贴新登录 demote + 置当前活跃
两张牌同时贴着双活 → 推送 / 列表重复
门禁日志留旧牌记录行保留、只改活跃位(审计)

类比局限:门禁卡解释「同一时刻谁占用设备」;解释不了指纹漂移、也不解释多实例上的连接登记——那两块见上文系列链接。

双活映射:同一设备上两个活跃用户,推送网关对同一设备重复下发
双活映射:同一设备上两个活跃用户,推送网关对同一设备重复下发 · 点击查看 SVG 原图

硬规则:单设备单活跃

不变量先书面定义,再谈索引与脚本;「文档里应该只有一个」不算保证。

合同项推荐默认(教学)别混进去
每设备活跃用户数≤ 1「用户允许多设备」是另一维
非活跃行保留(审计 / 「曾在此登录」)除非合规要求,勿默认物理删除
查询默认active=true推送扇出、设备列表同一过滤
并发事务内 demote + 部分唯一兜底只靠应用层「约定」

部分唯一索引(partial unique index):只对「活跃」行施加唯一——常见形态是 (device_id) 在 active=true 条件下唯一。绿场也可把「当前用户」收成设备上的指针字段;历史 mapping 另表。两种都能钉死不变量,差别在模型复杂度与迁库成本。


模式对照:约定、demote、约束、指针

生产推荐:先清脏,再上部分唯一,写路径 demote 双保险;不要长期停在「文档约定」。

模式做法代价适用
A. 仅应用层约定文档写「应该只有一个 active」并发登录必双活;无库级兜底不可接受生产
B. 登录时应用层 demote事务内把旧 active → false,再置当前要处理并发;漏路径仍双活过渡 / 与 C 组合
C. 部分唯一索引(device_id) WHERE active 唯一迁库 / 修数要先清脏生产推荐
D. 活跃改存「当前指针」设备文档上 current_user_id历史 mapping 另表;模型更简绿场可考虑
E. 批量修复作业聚合 count(active)>1,按优先级只留一个要幂等、可抽样回滚引入约束前必做

教学倾向顺序:E 清脏 → C 上约束 → B 写路径 demote。A 可以当答辩反例,不当长期态。

登录成功:事务内 demote 旧活跃,再置当前活跃;部分唯一索引兜底并发双写
登录成功:事务内 demote 旧活跃,再置当前活跃;部分唯一索引兜底并发双写 · 点击查看 SVG 原图

写路径与修复:同一套胜者

线上 demote 与离线修复必须共用「谁留下」的规则;否则修完一周又双活,或索引创建失败。

对同一 device_id 下多个 active,教学示意优先级:

  1. last_seen / last_login_at 最新者胜;
  2. 相同则 created_at 最新;
  3. 再相同则主键 / 版本号更新者胜;
  4. 其余全部 active=false(保留行)。
修复漏斗:按 last_login、created_at、主键选出唯一胜者,其余降为非活跃
修复漏斗:按 last_login、created_at、主键选出唯一胜者,其余降为非活跃 · 点击查看 SVG 原图

教学伪流程(脱敏,非生产 API):

登录成功(device_id, user_id):
  BEGIN
    UPDATE mappings SET active=false
      WHERE device_id=? AND active=true AND user_id<>?
    UPSERT mapping(device_id, user_id)
      SET active=true, last_login_at=now()
  COMMIT
  -- 部分唯一索引兜底并发双写

修复作业:
  GROUP BY device_id HAVING count(active=true) > 1
  → 选胜者 → 其余 active=false
  → 抽样校验后再 CREATE UNIQUE INDEX ... WHERE active

代价先说清:上约束前必须修数——脏数据在,唯一索引建不起来或写入开始 500;只修数不上索引,并发登录下周又双活;推送若仍按「用户所有 token」扇出且不过滤 active,mapping 修干净了门铃照样响两遍。


反模式

最贵的不是多写几行 demote,而是「修了表象、合同仍松」。

反模式为什么疼
只修数据不上索引并发路径一开又双活
推送 / 列表不过滤 active不变量在库里成立,产品侧仍重复
「用户多设备」与「设备多用户」揉成一个唯一键误杀合法多端,或放行非法双活
修复时物理删除 mapping丢审计与「曾在此设备登录」证据
修复胜者规则与登录 demote 不一致作业与写路径互相踩;难复盘

选型结论

  1. 先书面定义不变量:每设备几个活跃用户、每用户几台活跃设备——两维分开写。
  2. 登录写路径 demote + 部分唯一索引双保险;别长期停在模式 A。
  3. 历史双活用确定性优先级修复,再上约束;修复与线上共用胜者规则。
  4. 推送与设备列表查询默认 active=true;修 mapping 不同时改扇出过滤,门铃仍会响两遍。
  5. 分工:指纹分层回答「是不是同一台」;连接登记回答「此刻哪些端在线」;本文回答「这台设备当前活跃归属谁」。

系列导航: