原生移动开发 / 系统课时
管理多通道设备 Token
管理多通道设备 Token
多厂商推送真正难管理的不是“保存一个 Token”,而是同一个用户可能拥有多台设备、每台设备同时存在不同通道 Token,并且 Token 会刷新、失效和注销。本课建立用户—设备—Token 的服务端绑定模型,让这些变化都能被明确记录。
学习目标
- 区分用户、设备、推送通道和 Token 四类业务对象
- 设计支持刷新、注销和多设备的 Token 绑定表
- 避免用单个用户 Token 字段覆盖多设备或多通道数据
先确定数据关系
用户与设备通常是一对多关系,一个设备又可能对应多个推送通道 Token。例如同一台 Android 设备可以保存 FCM Token 和厂商 Token。Token 是可变凭据,不能直接当作设备的永久身份。
因此服务端至少应能回答四个问题:这个 Token 属于哪个用户、来自哪台设备、属于哪个 Provider、当前是否仍然有效。把这些关系拆开后,刷新 Token 只修改 Token 记录,不会误伤用户或设备身份。

设计 Token 绑定表
下面用 PostgreSQL 展示一种最小可用模型。user_device 保存设备身份,push_token 保存具体通道凭据,并通过唯一约束避免同一设备出现重复的同通道 Token 记录。
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)
);预期结果
表结构创建成功;同一用户可拥有多个 device_id,同一 device_id 可分别保存 FCM 和厂商 Provider 的 Token。这里的 device_key 不建议直接使用容易变化的业务字段,例如用户昵称。它需要代表“这次安装实例对应的设备记录”,具体生成策略应结合你的登录体系和隐私要求确定。
处理 Token 刷新
客户端收到新的 Token 后,不应该先删除旧记录再插入新记录。更稳定的做法是以“设备 + Provider”定位绑定关系,再更新 Token 和状态。这样刷新是幂等的,重复上报同一个 Token 也不会产生重复数据。
UPDATE push_token
SET token = '<TOKEN>',
status = 'ACTIVE',
updated_at = NOW()
WHERE device_id = <DEVICE_ID>
AND provider = 'FCM';片段示例:<TOKEN> 和 <DEVICE_ID> 代表真实请求中的运行时值,实际值会因设备不同而变化。生产实现通常还会在未找到记录时执行插入或使用数据库原生 upsert。
预期结果
匹配的 FCM Token 记录被更新为最新 Token,并恢复为 ACTIVE;updated_at 同步变化。处理注销与多设备
用户退出登录时,不要简单删除用户全部 Token,因为同一账号可能还登录着其他设备。通常只注销当前设备对应的有效绑定,并根据产品需求决定是否保留设备记录。
例如当前设备注销后,可以把对应 Token 标记为 REVOKED。这样发送服务筛选 ACTIVE Token 时自然跳过它,同时历史记录仍可用于审计和排查。
发送前如何选择有效 Token
推送发送侧只需要选择有效 Token,而不应该猜测客户端当前使用哪个 SDK。一个常见查询是按用户和状态获取全部有效绑定,再按 Provider 分组交给对应发送器。
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>
);预期结果
返回该用户所有设备上状态为 ACTIVE 的 Token,每行标识具体 device_id、provider 和 token;已注销 Token 不出现在结果中。服务端发送失败后,还应根据厂商返回的失效信号处理 Token 生命周期。不要仅凭一次网络异常就删除 Token;网络超时、服务暂时不可用与 Token 已失效是不同类型的故障,应分别处理。
最终的数据边界可以保持为:User 表示账号,Device 表示安装实例,PushToken 表示某个 Provider 的当前凭据。这样 Token 刷新只影响 Token,单设备注销只影响该设备,新增厂商也只需增加新的 Provider 值和对应发送适配器。