Android 5.0集成Firebase FCM推送失败问题求助

一、修复FCM依赖的正确配置 #

• 核心问题是依赖库添加位置错误：
  • implementation 'com.google.firebase:firebase-messaging:23.0.8' 必须放在模块级build.gradle（通常是app/build.gradle）的dependencies块中，而非项目根目录的build.gradle的classpath里。
  • 根目录build.gradle只需保留Firebase插件的classpath，示例：

    dependencies {
        classpath 'com.google.gms:google-services:4.3.15' // 适配Android 5.0的插件版本
    }
    

  • 模块级build.gradle的正确配置：

    dependencies {
        implementation 'com.google.firebase:firebase-messaging:23.0.8'
    }
    // AGP 7.0+ 可在plugins块声明，否则在文件末尾添加
    apply plugin: 'com.google.gms.google-services'
    

  • 之前implementation编译错误的可能原因：需确保compileSdkVersion至少设为31以上，targetSdkVersion不低于21，保证与Firebase依赖版本的兼容性。

二、确保FCM推送接收的基础配置 #

• 除网络权限外，需在Manifest中配置FCM消息服务（若未自动生成）：

  <service
      android:name=".MyFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

• 创建对应的消息处理类，重写核心方法：

  public class MyFirebaseMessagingService extends FirebaseMessagingService {
      @Override
      public void onMessageReceived(RemoteMessage remoteMessage) {
          // 处理推送消息
          if (remoteMessage.getNotification() != null) {
              String title = remoteMessage.getNotification().getTitle();
              String body = remoteMessage.getNotification().getBody();
              showLocalNotification(title, body);
          }
      }
  
      @Override
      public void onNewToken(String token) {
          // 处理设备令牌更新
      }
  
      private void showLocalNotification(String title, String body) {
          // 实现本地通知显示逻辑
      }
  }
  

三、解决推送延迟问题 #

• 确认设备已安装适配Android 5.0的Google服务框架，且网络连接稳定；
• 若使用定制ROM，将应用加入后台白名单，避免被系统清理；
• 测试优先使用数据消息（需自行处理显示），而非FCM直接推送的通知消息，便于排查是否成功接收。

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