Firebase与QuickBlox集成推送通知Token失效问题排查求助

我来帮你梳理下这个问题，结合Firebase和QuickBlox的集成逻辑，可能的原因和解决方向大概有这些：

一、后台运行后Token失效（NotRegistered）的可能原因 #

• Firebase Token刷新与QuickBlox同步不及时：Firebase会在多种场景下自动刷新Token（比如应用更新、系统版本升级、用户卸载重装、后台长时间休眠被系统回收资源等）。如果你的应用没有在onNewToken回调里及时把新Token同步到QuickBlox服务器，就会导致QuickBlox用旧Token推送时触发NotRegistered错误。尤其是后台运行时，Android 8.0+的Doze模式、App Standby等后台限制，可能会导致onNewToken无法及时触发，或者同步请求被系统拦截。
• QuickBlox的Token缓存未更新：QuickBlox SDK可能会缓存旧的Firebase Token，即便本地获取到新Token，SDK也没有主动替换服务器上存储的旧值。你需要确认每次获取新Token后，是否调用了QuickBlox的QBMessages.registerSubscription或相关更新接口，确保服务器端的Token是最新的。
• 系统后台资源限制：部分厂商的定制ROM（比如小米、华为）会对后台应用的网络、任务执行做更严格的限制，导致Token同步请求无法在后台完成。这种情况下，建议使用WorkManager来封装Token同步任务，确保任务能在系统允许的时机执行。

二、升级Firebase到17.5+后Token立即失效的问题 #

这个版本的Firebase Messaging有不少API和内部逻辑调整，结合你的情况，可能的原因：

• Token获取API的兼容性问题：从17.5版本开始，Firebase废弃了旧的InstanceId.getToken()方法，改用FirebaseMessaging.getInstance().token异步获取。如果你的代码还在混用旧API，可能拿到的是临时Token或无效值。建议统一使用新的API：

  FirebaseMessaging.getInstance().token.addOnCompleteListener { task ->
      if (!task.isSuccessful) {
          Log.w(TAG, "Fetching FCM registration token failed", task.exception)
          return@addOnCompleteListener
      }
      // 获取到有效Token后同步到QuickBlox
      val token = task.result
      updateTokenToQuickBlox(token)
  }
  

• QuickBlox SDK版本兼容性：你使用的QuickBlox 3.9.2版本可能没有适配Firebase 17.5+的变更，导致SDK内部处理Token的逻辑出错。建议检查QuickBlox官方文档，尝试升级到更高版本的SDK（比如4.x系列），查看其Release Notes是否有关于Firebase兼容性的说明。
• Token作用域的区分：高版本Firebase对Token的作用域做了更严格的区分，如果QuickBlox需要的是特定Sender ID的Token，而你获取的是默认作用域的Token，就会出现无效的情况。可以尝试指定Sender ID获取Token（注意：该方法在更高版本中已废弃，仅作为测试用）：

  FirebaseInstanceId.getInstance().getToken(YOUR_FCM_SENDER_ID, "FCM")
  

三、通用排查步骤 #

• 添加详细日志：在onNewToken回调、Token同步到QuickBlox的方法里添加日志，记录Token的生成时间、具体值，以及同步请求的结果，这样能快速定位是Token没有刷新，还是同步环节出了问题。
• 单独测试Firebase Token有效性：拿到新Token后，直接用Firebase Console推送测试消息，看是否能正常接收。如果可以，说明问题出在QuickBlox的集成环节；如果不行，就是Firebase本身的配置或Token获取逻辑有问题。
• 检查Manifest配置：确保AndroidManifest.xml里正确配置了FCM相关权限和服务：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.WAKE_LOCK" />
  
  <service
      android:name=".YourFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

• 重置测试环境：卸载重装应用，清除Firebase控制台里的旧Token记录，重新走一遍Token生成、同步到QuickBlox的流程，排除缓存导致的问题。

内容的提问来源于stack exchange，提问作者EricPolman