Android API 21设备Firebase Cloud Messaging (FCM)无法接收推送问题排查

针对API 21（Android 5.0）设备无法接收含数据载荷的FCM推送消息，核心原因集中在该版本系统与FCM机制的兼容性差异上，具体如下：

• 后台数据消息路由逻辑不同：API 21及更低版本中，FCM的数据消息（仅含data字段的推送）在应用处于后台或进程被杀死时，不会触发FirebaseMessagingService的onMessageReceived()方法，而是直接被系统通知栏拦截；若你的应用未处理系统通知栏的消息转发，就会出现收不到的情况。而API 23+版本中，FCM优化了路由逻辑，无论应用状态如何，数据消息都会优先传递到自定义服务的回调方法。

• 早期后台唤醒限制：Android 5.0虽未正式推出Doze模式，但已经引入了初步的后台进程唤醒限制。当应用在后台时，FCM的数据消息可能无法唤醒你的FirebaseMessagingService进程，导致消息无法被接收和处理。

• FCM SDK版本适配问题：若使用较新版本的FCM SDK，其针对高版本API的优化逻辑可能未完全兼容API 21的旧有处理流程，比如在消息解析、服务唤醒等环节存在逻辑遗漏，导致数据消息无法正确送达。

• 数据载荷格式兼容性：API 21对FCM数据载荷的格式要求更严格，若payload中存在未正确序列化的字段、类型不匹配（如数值类型传递字符串）或不符合FCM规范的字段，系统会直接丢弃消息；而高版本API对这类格式问题有更强的容错性，不会轻易丢弃消息。

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