Android中FirebaseMessagingService应用退出后台后失效问题求助

一、服务被销毁的核心原因 #

1. Android原生后台限制：从Android 8.0（API 26）起，系统引入严格的后台服务限制机制。当应用从最近任务栏移除后进入后台空闲状态，系统会主动限制后台服务的资源占用，甚至直接销毁进程以节省资源，FirebaseMessagingService作为后台服务也会受此影响。
2. Data消息的接收特性：FCM的纯Data消息（payload不含notification字段）需要应用进程存活才能被onMessageReceived回调处理。如果进程已被销毁，系统不会自动唤醒进程接收Data消息，只有Notification类型的消息会由系统接管并显示通知。
3. 厂商ROM的额外限制：国内主流厂商（小米、华为、OPPO、vivo等）的定制ROM有强化的后台管理策略，即使符合Android原生规则，也会直接杀死后台进程，导致服务被强制销毁。

二、防止服务被销毁的解决方案 #

1. 优化消息Payload格式 #

优先使用Notification + Data的混合消息格式：

• 应用在前台时，onMessageReceived会接收完整消息，可自定义处理逻辑；
• 应用在后台或进程被销毁时，系统会自动显示通知栏消息，用户点击后唤醒应用并传递Data数据到启动的Activity。
  示例Payload结构：

{
  "notification": {
    "title": "新消息",
    "body": "您有一条未读聊天消息"
  },
  "data": {
    "chatId": "123",
    "content": "Hello World"
  },
  "to": "<FCM_TOKEN>"
}

2. 启动前台服务（针对纯Data消息场景） #

如果必须使用纯Data消息，可在onMessageReceived中启动前台服务，让系统认为应用处于活跃状态，避免进程被销毁：

override fun onMessageReceived(remoteMessage: RemoteMessage) {
    super.onMessageReceived(remoteMessage)
    // 适配Android 8.0+的通知渠道
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        val channel = NotificationChannel(
            "FCM_BACKGROUND_CHANNEL",
            "FCM后台监听",
            NotificationManager.IMPORTANCE_LOW
        ).apply {
            setSound(null, null) // 设置静音，避免打扰用户
        }
        val notificationManager = getSystemService(NotificationManager::class.java)
        notificationManager.createNotificationChannel(channel)
    }
    // 构建前台通知
    val notification = NotificationCompat.Builder(this, "FCM_BACKGROUND_CHANNEL")
        .setSmallIcon(R.drawable.ic_notification)
        .setContentTitle("后台监听中")
        .setContentText("正在接收聊天消息")
        .setPriority(NotificationCompat.PRIORITY_LOW)
        .build()
    // 启动前台服务
    startForeground(1, notification)
    
    handleMessage(remoteMessage)
    // 若处理完消息无需持续监听，可停止前台服务
    // stopForeground(STOP_FOREGROUND_REMOVE)
}

3. 适配厂商后台白名单 #

引导用户将应用加入厂商的后台白名单，不同厂商操作路径示例：

• 小米：设置 → 应用设置 → 应用管理 → 目标应用 → 省电策略 → 无限制
• 华为：设置 → 应用和服务 → 应用启动管理 → 目标应用 → 关闭自动管理，打开允许自启动、允许后台活动
• OPPO：设置 → 电池 → 应用耗电管理 → 目标应用 → 允许后台耗电

4. 检查Manifest配置 #

确保FirebaseMessagingService注册正确，避免设置android:stopWithTask="true"（该属性会让服务在任务移除时自动停止）：

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

5. 使用WorkManager处理异步任务 #

如果消息处理不需要实时响应，可将handleMessage的逻辑迁移到WorkManager中，即使进程被销毁，WorkManager也会在系统资源充足时自动执行任务：

fun handleMessage(remoteMessage: RemoteMessage) {
    val data = remoteMessage.data
    val workRequest = OneTimeWorkRequestBuilder<MessageProcessingWorker>()
        .setInputData(Data.Builder().putAll(data).build())
        .build()
    WorkManager.getInstance(this).enqueue(workRequest)
}

class MessageProcessingWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
    override fun doWork(): Result {
        val data = inputData.keyValueMap
        // 执行消息处理逻辑
        return Result.success()
    }
}

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