如何将Firebase Cloud Messaging集成至Android库模块并解决初始化及通知异常问题

看起来你已经走了大部分正确的路——手动初始化FCM、封装库逻辑，这俩问题其实都是和FirebaseApp初始化时机/范围以及FCM消息处理机制相关的，我来给你拆解一下解决方案：

一、解决前台接收通知时的崩溃问题 #

你遇到的Default FirebaseApp is not initialized错误，核心原因是FCM的Analytics或Messaging组件可能在你初始化FirebaseApp之前就尝试访问它，或者你的初始化只在主进程执行，但FCM的Service可能运行在其他进程中（比如部分厂商系统会把推送服务放在独立进程）。

具体修复步骤： #

1. 将初始化时机提前到Application创建阶段
   建议在你的库中封装初始化方法，要求宿主应用在自定义Application的onCreate()中调用，这样能保证在任何组件（包括FCM的Service）启动前完成初始化。
   库中封装的初始化逻辑示例：

   public class FcmLibraryInitializer {
       public static void init(Context context, String applicationId, String apiKey, String senderId, String projectId) {
           // 先检查是否已初始化，避免重复操作
           if (FirebaseApp.getApps(context).isEmpty()) {
               FirebaseOptions options = new FirebaseOptions.Builder()
                   .setApplicationId(applicationId)
                   .setApiKey(apiKey)
                   .setGcmSenderId(senderId)
                   .setProjectId(projectId)
                   .build();
               FirebaseApp.initializeApp(context, options);
           }
       }
   }
   

   宿主应用的MyApplication中调用：

   @Override
   public void onCreate() {
       super.onCreate();
       FcmLibraryInitializer.init(this, "你的applicationId", "你的apiKey", "你的senderId", "你的projectId");
   }
   

2. 处理多进程场景的初始化
   如果你的MyMessagingService运行在非主进程，主进程的初始化不会覆盖到这个进程。可以在Service的onCreate()中再次检查并初始化：

   @Override
   public void onCreate() {
       super.onCreate();
       // 这里需要从宿主传递配置参数，或提前存在SharedPreferences中
       if (FirebaseApp.getApps(this).isEmpty()) {
           FirebaseOptions options = new FirebaseOptions.Builder()
               .setApplicationId(...)
               .setApiKey(...)
               .setGcmSenderId(...)
               .setProjectId(...)
               .build();
           FirebaseApp.initializeApp(this, options);
       }
   }
   

二、解决后台无通知显示的问题 #

后台接收通知分两种场景，对应不同的处理逻辑：

1. 发送「通知消息」（Notification Message）时
   这种消息由系统通知栏直接处理，不需要你的Service介入，但要满足以下条件：

   • 手动初始化的参数完全正确，尤其是GcmSenderId必须和Firebase控制台一致
   • 确保库的Manifest已合并到宿主应用，Service的intent-filter配置正确：

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

   • 宿主应用已开启通知权限，部分国产ROM需单独开启「后台弹出通知」权限

2. 发送「数据消息」（Data Message）时
   这种消息无论前台后台都会传递到onMessageReceived()，但后台时需要你手动构建并显示通知。示例逻辑：

   @Override
   public void onMessageReceived(RemoteMessage remoteMessage) {
       super.onMessageReceived(remoteMessage);
       // 构建通知
       NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "your_channel_id")
           .setSmallIcon(R.drawable.ic_notification)
           .setContentTitle(remoteMessage.getData().get("title"))
           .setContentText(remoteMessage.getData().get("body"))
           .setPriority(NotificationCompat.PRIORITY_DEFAULT);
   
       NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
       // Android O及以上需先创建通知渠道
       createNotificationChannel();
       notificationManager.notify(1, builder.build());
   }
   
   private void createNotificationChannel() {
       if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
           CharSequence name = "推送通知渠道";
           String description = "接收FCM推送通知";
           int importance = NotificationManager.IMPORTANCE_DEFAULT;
           NotificationChannel channel = new NotificationChannel("your_channel_id", name, importance);
           channel.setDescription(description);
           NotificationManager notificationManager = getSystemService(NotificationManager.class);
           notificationManager.createNotificationChannel(channel);
       }
   }
   

额外注意事项 #

• 手动初始化用的ApiKey必须是Firebase控制台生成的Android API密钥，不能用错类型
• 测试后台通知时，建议用Firebase控制台的「Cloud Messaging」发送测试消息，选择「通知」类型更易验证
• 确保依赖的FCM库版本与你的初始化逻辑兼容，避免版本冲突

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