Firebase Console定期FCM通知无法接收问题求助

问题描述 #

我在Android原生应用中集成了FCM，即时通知与定时通知均能正常工作，但通过Firebase Console创建的定期通知无法被接收。

应用中使用的依赖库如下，且未自定义Firebase Messaging类，而是使用SDK自带的类接收消息：

//firebase
// Import the BoM for the Firebase platform
implementation platform('com.google.firebase:firebase-bom:31.1.0')
implementation 'com.google.firebase:firebase-analytics'
implementation 'com.google.firebase:firebase-messaging'

排查与解决步骤 #

• 核对定期通知配置
  检查Firebase Console里的定期通知设置：

  • 确认触发时间、重复周期、时区设置是否正确，避免因时区偏差导致通知未到触发时间
  • 确认目标受众是否匹配你的应用包名，有没有误选其他分组或设备
  • 检查通知优先级设置，低优先级通知可能被系统延迟或拦截

• 解除应用后台限制

  • 针对小米、华为、OPPO等国产ROM，将应用加入后台白名单，关闭电池优化策略，避免应用被休眠导致无法接收FCM唤醒指令
  • 确保应用未被强制停止，强制停止状态下FCM无法向应用推送任何通知

• 升级Firebase依赖版本
  当前使用的31.1.0版本存在部分调度逻辑的bug，建议升级到最新稳定版Firebase BOM，示例：

  implementation platform('com.google.firebase:firebase-bom:32.7.1')
  

  同步项目后重新测试定期通知功能

• 查看Logcat日志定位问题
  过滤FirebaseMessaging标签，检查是否有定期通知的调度记录、错误日志，比如是否存在服务器指令接收失败、本地调度异常等信息

• 确认通知权限状态
  Android 13及以上系统需要POST_NOTIFICATIONS权限，若应用未获得该权限，即使FCM收到消息也无法弹出通知。前往应用设置手动开启通知权限后再测试

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