原生移动开发 / 系统课时

管理 FCM Token 注册刷新

管理 FCM Token 注册刷新

本课解决 FCM 最容易留下隐患的一步:客户端拿到 token 只是开始,真正可用的推送体系还必须持续把当前 token 同步给服务端,并在 token 变化后替换旧记录。完成后,服务端保存的是“用户当前安装实例对应的最新标识”。

学习目标

  • 能在首次注册和 token 刷新时执行统一同步逻辑
  • 能避免把旧 token 当成永久设备标识
  • 能设计客户端持久化与服务端更新的最小闭环

Token 为什么必须允许变化

FCM registration token 不能当作永不变化的设备 ID。官方文档列出的变化场景包括应用恢复到新设备、卸载重装以及清除应用数据,因此服务端必须接受新 token 并更新对应记录。([Firebase][3])

FCM Token 注册与刷新同步流程

统一处理首次获取与刷新

首次安装或初始化时,可以调用 getToken() 获取当前 token;后续发生刷新时,FCM 会回调 onNewToken()。不要在两个路径里各写一套上传逻辑,而是让它们都进入同一个注册函数。

kotlin
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")
    }
}

预期结果

text
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 调用成功,但消息一直发往旧设备标识”的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

管理 FCM Token 注册刷新

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

登录哪都通