Flutter iOS端FCM通知失效求助：InvalidRegistration报错

核心结论 #

开发者模式不会直接导致FCM令牌反复失效，APN令牌失效/被取消是更可能的核心原因（针对iOS平台），同时也存在其他潜在触发因素。

详细分析 #

• 开发者模式的影响排除：开发者模式仅开启调试相关权限（如USB调试、应用日志查看），不会主动触发FCM令牌的失效或刷新逻辑，因此可以排除该因素。

• APN令牌的关联影响：
  FCM在iOS平台完全依赖APNs推送通道，当APN令牌出现以下情况时，对应的FCM令牌会同步失效：

  • 用户卸载重装应用、重置设备、切换Apple ID，或手动关闭应用推送权限，苹果服务器会标记旧APN令牌无效
  • 苹果会定期更新APN令牌，若应用未监听APN令牌变化并同步更新FCM令牌，旧令牌会逐渐失效
  • 开发环境的APNs证书过期、配置错误，或证书与当前应用运行环境（开发/生产）不匹配，会导致APN令牌无法被验证，进而触发FCM的InvalidRegistration错误

• 其他可能的触发因素：

  • 应用被系统长期杀死，FCM心跳连接中断，服务器会标记令牌失效
  • 设备长期处于异常网络环境，FCM无法完成令牌刷新同步
  • Firebase项目配置错误，如Android端的SHA-1/SHA-256指纹未正确配置（针对Android平台）

排查与解决步骤 #

1. 监听FCM令牌刷新，同步到后端：
   在Flutter代码中添加令牌刷新监听，确保新令牌及时替换后端存储的旧令牌：

   FirebaseMessaging.instance.onTokenRefresh.listen((newToken) {
     // 将新令牌发送至后端更新存储
     updateUserToken(newToken);
   });
   

2. 检查推送权限状态：
   确认用户未关闭应用推送权限，必要时引导开启：

   NotificationSettings settings = await FirebaseMessaging.instance.requestPermission();
   if (settings.authorizationStatus != AuthorizationStatus.authorized) {
     // 提示用户前往设置开启推送权限
   }
   

3. 验证APNs配置（iOS）：
   检查Firebase控制台的APNs证书：确保开发环境使用开发证书，生产环境使用生产证书，证书未过期且Bundle ID与应用一致。

4. 处理失效令牌：
   当收到InvalidRegistration错误时，立即从后端移除对应的失效令牌，避免后续无效推送。

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