原生移动开发 / 系统课时
管理 FCM Token 注册刷新
管理 FCM Token 注册刷新
本课解决 FCM 最容易留下隐患的一步:客户端拿到 token 只是开始,真正可用的推送体系还必须持续把当前 token 同步给服务端,并在 token 变化后替换旧记录。完成后,服务端保存的是“用户当前安装实例对应的最新标识”。
学习目标
- 能在首次注册和 token 刷新时执行统一同步逻辑
- 能避免把旧 token 当成永久设备标识
- 能设计客户端持久化与服务端更新的最小闭环
Token 为什么必须允许变化
FCM registration token 不能当作永不变化的设备 ID。官方文档列出的变化场景包括应用恢复到新设备、卸载重装以及清除应用数据,因此服务端必须接受新 token 并更新对应记录。([Firebase][3])

统一处理首次获取与刷新
首次安装或初始化时,可以调用 getToken() 获取当前 token;后续发生刷新时,FCM 会回调 onNewToken()。不要在两个路径里各写一套上传逻辑,而是让它们都进入同一个注册函数。
import android.util.Log
import com.google.firebase.messaging.FirebaseMessagingService
import com.google.firebase.messaging.RemoteMessage
class MyFirebaseMessagingService : FirebaseMessagingService() {
override fun onNewToken(token: String) {
super.onNewToken(token)
// 所有 token 变化都走同一条同步路径,避免遗漏服务端更新。
registerCurrentToken(token)
}
override fun onMessageReceived(message: RemoteMessage) {
Log.d("FCM", "message received: ${message.messageId ?: "<NO_ID>"}")
}
private fun registerCurrentToken(token: String) {
// 这里应先持久化,再调用你自己的 HTTPS API 同步服务端。
getSharedPreferences("fcm", MODE_PRIVATE)
.edit()
.putString("current_token", token)
.apply()
Log.d("FCM", "current token saved")
}
}预期结果
D/FCM: current token saved这是一个完整的客户端示例,但 registerCurrentToken() 中的业务服务端请求仍需按你的后端接口实现;不能把日志保存误认为“服务端已经更新”。
服务端同步要保存什么
最小设计不是只存一列 token,而是至少能回答“这个 token 属于谁、最近什么时候同步”。通常可以保存用户标识、当前 token、更新时间;若一个用户允许多台设备同时登录,则应把安装实例作为独立记录,而不是强制一个用户只有一个 token。
| 字段 | 用途 |
|---|---|
userId |
关联业务账户 |
token |
当前 FCM registration token |
updatedAt |
判断注册新鲜度 |
installationId |
多设备场景下区分不同安装实例 |
客户端每次成功上传都更新 updatedAt。服务端发送失败时,还应根据 FCM 返回的无效注册信息清理失效记录;官方建议处理 UNREGISTERED,而 INVALID_ARGUMENT 只有在消息请求本身有效时才能判断为注册标识无效。([Firebase][4])
避免把旧 Token 当永久标识
常见错误是用户登录时上传一次 token,此后服务端长期复用它。正确做法是把 token 看成“当前注册状态”,每次 onNewToken() 都覆盖或新增对应安装实例记录;客户端重新打开时,也可以重新取得当前 token 并执行一次幂等同步。
这样设计后,客户端负责发现当前 token,服务端负责保存最新注册状态并清理已知失效记录,两边职责明确,才能避免“推送 API 调用成功,但消息一直发往旧设备标识”的问题。