多进程Android应用中独立进程初始化Firebase Messaging无法接收消息问题

我之前折腾过Firebase多进程下的消息推送配置，你的思路其实是对的，但大概率是几个细节没处理到位，才导致onMessageReceived没触发。下面是我总结的几个关键排查点和修复建议：

1. 确保FirebaseApp初始化的参数完全正确 #

ContentProviders不会在子进程中创建，所以手动初始化是必须的，但一定要保证初始化用的FirebaseOptions和主进程的配置完全一致，否则子进程的Firebase实例无法正常和FCM服务器通信。

你可以这样做：

• 要么从主进程的默认Firebase实例中获取Options（如果主进程已经初始化），要么直接从google-services.json里提取参数手动构建。
• 初始化前先检查是否已经有实例存在，避免重复初始化抛出异常。

示例代码：

@Override
public void onCreate() {
    super.onCreate();
    // 检查子进程中是否已初始化FirebaseApp
    if (FirebaseApp.getApps(this).isEmpty()) {
        FirebaseOptions options = new FirebaseOptions.Builder()
                .setProjectId("你的项目ID")
                .setApplicationId("你的应用ID")
                .setApiKey("你的API Key")
                .setGcmSenderId("你的Sender ID") // 这个很重要，FCM依赖它
                .build();
        // 给子进程的FirebaseApp指定唯一名称，避免和主进程默认实例冲突
        FirebaseApp.initializeApp(this, options, "secondary-firebase-app");
    }
}

2. 修正清单文件的进程配置细节 #

你清单里的进程配置android:process="secondary"其实有个小问题：如果不加前面的冒号，这个会变成全局进程名，容易和其他应用的进程冲突，正确的写法应该是:secondary，代表属于当前应用的私有子进程。

修正后的清单配置：

<service 
    android:name=".xxx.yyy.FirebaseListenerService" 
    android:enabled="true" 
    android:process=":secondary" 
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

3. 确认发送的是能触发onMessageReceived的消息类型 #

这里很容易踩坑：FCM的消息分两种，通知消息和数据消息：

• 通知消息：默认会直接显示在系统通知栏，不管你的应用在前台还是后台，都不会触发onMessageReceived；
• 数据消息：所有情况下都会直接传递给你的FirebaseMessagingService，触发onMessageReceived；
• 混合消息（通知+数据）：只有当应用在前台时，才会触发onMessageReceived，后台时系统会显示通知，点击通知才会把数据传给应用。

所以测试的时候一定要发送纯数据消息，比如用Firebase控制台选择“自定义数据”，或者用API发送如下格式的请求：

{
  "to": "你的设备Token",
  "data": {
    "key1": "value1",
    "key2": "value2"
  }
}

4. 升级Firebase SDK到最新稳定版 #

某些旧版本的Firebase Messaging SDK在多进程场景下存在兼容性问题，建议你把firebase-messaging依赖升级到最新的稳定版，比如：

implementation 'com.google.firebase:firebase-messaging:24.0.0' // 以实际最新版本为准

5. 验证子进程的启动状态 #

可以在FirebaseListenerService的onCreate方法里添加日志，确认子进程确实已经启动，比如：

@Override
public void onCreate() {
    super.onCreate();
    Log.d("FirebaseListener", "Secondary process started, initializing Firebase");
    // 初始化代码...
}

发送消息前先确认日志已经输出，再测试消息接收。

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