Android 12/API 30+环境下Xamarin应用FCM通知失效、Token无效问题问询

• 优先检查Android 12专属配置适配
  • 必须在AndroidManifest.xml中显式声明android.permission.POST_NOTIFICATIONS权限，且在应用启动时主动申请该运行时权限。全新安装Android 12的设备默认不会授予应用通知权限，而从低版本升级上来的设备会继承之前的权限状态，刚好匹配你遇到的用户差异特征。
  • 检查所有FCM相关的服务、接收器组件（比如FirebaseMessagingService、InstanceIdReceiver等），如果配置了intent-filter，必须显式添加android:exported属性：接收外部FCM广播的组件设为android:exported="true"，仅内部调用的组件设为android:exported="false"，API 31+未正确配置该属性会导致FCM服务无法正常注册，进而生成无效token。
• 调整token生成与上报逻辑
  • 废弃旧的OnTokenRefresh回调逻辑，改用新版Firebase库提供的FirebaseMessaging.Instance.GetToken().AddOnCompleteListener()接口主动拉取最新token，不要依赖系统被动回调刷新。Android 12上存在旧的token刷新回调不触发的已知问题，会导致应用上报的是本地缓存的过期token，实际该token已经被FCM服务端作废。
  • 新增token校验逻辑：每次应用冷启动、用户首次打开应用、申请完通知权限后，都主动拉取一次当前最新token，和本地存储的token比对，如果不一致立即重新上报到业务服务端，同时添加服务端返回token无效错误时，主动触发重新拉取上报的逻辑。
  • 调整上报时机：不要在应用首次启动还未完成FCM注册流程时就提前读取、上报空值或者无效值，Android 12全新安装设备首次启动时FCM注册耗时会比旧系统更长，要等注册完成回调后再执行上报操作。
• 清理库残留与版本冲突
  • 完全清理旧版本库的残留配置：删除项目packages目录下所有旧版本的Xamarin.Firebase.Messaging相关包，清理项目的bin、obj目录后重新编译，避免旧版库的缓存代码被打包进应用。
  • 确认所有Xamarin.GooglePlayServices、Xamarin.Firebase系列的Nuget包版本完全统一，不要出现部分包是旧版本、部分是新版本的情况，版本不一致是导致依赖冲突和FCM功能异常的最常见原因。
• 兜底修复方案
  • 给受影响用户提供手动触发通知修复的入口，用户点击后执行：清空本地存储的token、注销当前FCM实例、重新注册FCM、拉取新token上报的完整流程，90%以上的持续无效token问题都可以通过该操作修复。
  • 在应用的错误日志中新增FCM注册失败、token无效的埋点，捕获具体的错误码，方便定位少数特殊场景的异常原因。

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