原生移动开发 / 系统课时

管理多通道设备 Token

管理多通道设备 Token

多厂商推送真正难管理的不是“保存一个 Token”,而是同一个用户可能拥有多台设备、每台设备同时存在不同通道 Token,并且 Token 会刷新、失效和注销。本课建立用户—设备—Token 的服务端绑定模型,让这些变化都能被明确记录。

学习目标

  • 区分用户、设备、推送通道和 Token 四类业务对象
  • 设计支持刷新、注销和多设备的 Token 绑定表
  • 避免用单个用户 Token 字段覆盖多设备或多通道数据

先确定数据关系

用户与设备通常是一对多关系,一个设备又可能对应多个推送通道 Token。例如同一台 Android 设备可以保存 FCM Token 和厂商 Token。Token 是可变凭据,不能直接当作设备的永久身份。

因此服务端至少应能回答四个问题:这个 Token 属于哪个用户、来自哪台设备、属于哪个 Provider、当前是否仍然有效。把这些关系拆开后,刷新 Token 只修改 Token 记录,不会误伤用户或设备身份。

用户设备与多通道 Token 关系

设计 Token 绑定表

下面用 PostgreSQL 展示一种最小可用模型。user_device 保存设备身份,push_token 保存具体通道凭据,并通过唯一约束避免同一设备出现重复的同通道 Token 记录。

sql
CREATE TABLE user_device (
    id BIGSERIAL PRIMARY KEY,
    user_id BIGINT NOT NULL,
    device_key VARCHAR(128) NOT NULL,
    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    UNIQUE (user_id, device_key)
);

CREATE TABLE push_token (
    id BIGSERIAL PRIMARY KEY,
    device_id BIGINT NOT NULL REFERENCES user_device(id),
    provider VARCHAR(32) NOT NULL,
    token TEXT NOT NULL,
    status VARCHAR(16) NOT NULL DEFAULT 'ACTIVE',
    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
    UNIQUE (device_id, provider)
);

预期结果

text
表结构创建成功;同一用户可拥有多个 device_id,同一 device_id 可分别保存 FCM 和厂商 Provider 的 Token。

这里的 device_key 不建议直接使用容易变化的业务字段,例如用户昵称。它需要代表“这次安装实例对应的设备记录”,具体生成策略应结合你的登录体系和隐私要求确定。

处理 Token 刷新

客户端收到新的 Token 后,不应该先删除旧记录再插入新记录。更稳定的做法是以“设备 + Provider”定位绑定关系,再更新 Token 和状态。这样刷新是幂等的,重复上报同一个 Token 也不会产生重复数据。

sql
UPDATE push_token
SET token = '<TOKEN>',
    status = 'ACTIVE',
    updated_at = NOW()
WHERE device_id = <DEVICE_ID>
  AND provider = 'FCM';

片段示例:<TOKEN> 和 <DEVICE_ID> 代表真实请求中的运行时值,实际值会因设备不同而变化。生产实现通常还会在未找到记录时执行插入或使用数据库原生 upsert。

预期结果

text
匹配的 FCM Token 记录被更新为最新 Token,并恢复为 ACTIVE;updated_at 同步变化。

处理注销与多设备

用户退出登录时,不要简单删除用户全部 Token,因为同一账号可能还登录着其他设备。通常只注销当前设备对应的有效绑定,并根据产品需求决定是否保留设备记录。

例如当前设备注销后,可以把对应 Token 标记为 REVOKED。这样发送服务筛选 ACTIVE Token 时自然跳过它,同时历史记录仍可用于审计和排查。

发送前如何选择有效 Token

推送发送侧只需要选择有效 Token,而不应该猜测客户端当前使用哪个 SDK。一个常见查询是按用户和状态获取全部有效绑定,再按 Provider 分组交给对应发送器。

sql
SELECT device_id, provider, token
FROM push_token
WHERE status = 'ACTIVE'
  AND device_id IN (
      SELECT id
      FROM user_device
      WHERE user_id = <USER_ID>
  );

预期结果

text
返回该用户所有设备上状态为 ACTIVE 的 Token,每行标识具体 device_id、provider 和 token;已注销 Token 不出现在结果中。

服务端发送失败后,还应根据厂商返回的失效信号处理 Token 生命周期。不要仅凭一次网络异常就删除 Token;网络超时、服务暂时不可用与 Token 已失效是不同类型的故障,应分别处理。

最终的数据边界可以保持为:User 表示账号,Device 表示安装实例,PushToken 表示某个 Provider 的当前凭据。这样 Token 刷新只影响 Token,单设备注销只影响该设备,新增厂商也只需增加新的 Provider 值和对应发送适配器。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理多通道设备 Token

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通