Flutter环境下如何获取非活跃用户的FCM Token？

首先咱们得戳破核心矛盾：FCM Token在用户没打开应用的时候没法主动刷新，而过期/失效的Token直接会导致推送翻车。所以解决方案得围绕「Token全生命周期管理」和「推送时的容错机制」来搭框架。

一、先把Token的日常维护做扎实（从客户端到后端） #

1. 客户端：抓住每一次活跃机会上传最新Token #

不管用户是登录账号还是只是打开应用（哪怕是匿名状态），只要应用启动、FCM自动刷新Token时，立刻把最新Token+用户标识（比如用户ID/设备唯一ID）+最后活跃时间同步到你的后端数据库。

• 举个Android端的代码例子：

  FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
      if (!task.isSuccessful) {
          return@addOnCompleteListener
      }
      val latestToken = task.result
      // 调用后端接口上传：用户ID、新Token、当前时间戳
      apiService.syncUserToken(userId, latestToken, System.currentTimeMillis())
  }
  

• 划重点：别只在用户登录时上传，应用每次启动都要检查上传——因为FCM可能在用户上次使用后悄悄刷新了Token，只有下次启动时客户端才能拿到新值。

2. 后端：给Token建个「健康档案」 #

• 数据库字段建议：用户ID、Token值、最后活跃时间、Token创建时间。
• 定期清理无效Token：
  • 当调用FCM推送API收到InvalidRegistration或NotRegistered错误时，立刻从数据库删掉对应的Token——这说明这个Token已经彻底凉了（比如用户卸载了应用）。
  • 搞个定时任务，比如每周清理一次「最后活跃时间超过90天」的Token，这类用户大概率已经流失，留着也是占空间。

二、针对长期未活跃用户的推送策略 #

用户多日没打开应用时，咱们没法主动去拿新Token，但可以通过这些方式提高推送成功率：

1. 推送前先给Token做个「体检」（可选） #

FCM的Admin SDK里有batchGet API，可以批量验证Token有效性。你可以在推送前，对目标用户的Token先做一轮校验，只给有效的Token发通知。

• 举个Node.js的代码例子：

  const admin = require("firebase-admin");
  // 待验证的Token列表
  const targetTokens = ["token_xxx", "token_yyy", "token_zzz"];
  
  admin.messaging().batchGet(targetTokens)
    .then((results) => {
      const validTokens = [];
      results.forEach((result, index) => {
        if (result.error) {
          console.error(`Token ${targetTokens[index]} 无效：${result.error}`);
          // 同步删除数据库里的无效Token
        } else {
          validTokens.push(targetTokens[index]);
        }
      });
      // 只给有效Token发通知
      if (validTokens.length > 0) {
        sendCustomNotification(validTokens);
      }
    });
  

• 注意：这个API有调用频次限制，别乱用，建议只对「最后活跃时间超过7天」的用户做校验。

2. 用高优先级通知触发后台唤醒（仅Android） #

如果用户的应用只是在后台（没被强制关闭），可以发高优先级通知，触发应用短暂唤醒——此时客户端能自动刷新Token并上传到后端。不过Android 12+对后台唤醒限制很严，这个只能当补充手段。

• 通知配置示例：

  {
    "message": {
      "token": "TARGET_TOKEN",
      "notification": {
        "title": "好久不见～",
        "body": "来看看我们的新功能吧"
      },
      "android": {
        "priority": "high",
        "notification": {
          "click_action": "OPEN_MAIN_ACTIVITY"
        }
      }
    }
  }
  

• 等用户点击通知打开应用时，客户端会自动刷新Token并同步，下次推送就有有效Token了。

3. 接受部分失败，靠用户后续活跃修复 #

没办法做到100%推送成功，对于失效的Token，咱们只能等用户下次打开应用时，自动上传新Token，再继续后续推送。后端要做好失败日志记录，方便后续分析优化。

三、额外提醒 #

• 别依赖单一Token：有些用户可能有多个设备（手机+平板），要把每个设备的Token都和用户ID绑定，推送时给所有有效Token发通知。
• 遵守平台规则：iOS的APNs和Android的FCM规则不一样，比如iOS静默通知不能加声音弹窗，否则会被系统拦截；Android要做好通知渠道配置，确保通知能正常显示。

内容的提问来源于stack exchange，提问作者Shaif Mohammad Reasat Dihan