Oreo系统下FCM数据消息后台无法触发onMessageReceived问题

根据你描述的场景——用FCM数据消息实现XMPP离线时的聊天通知，其他安卓版本正常，但Oreo后台时onMessageReceived无法触发，我来帮你梳理问题根源和可行解决方案：

核心原因分析 #

Android 8.0（Oreo，API 26）引入了两项关键系统限制，直接影响FCM数据消息的后台处理逻辑：

• 通知渠道强制要求：所有通知必须绑定已创建的通知渠道，否则系统会拦截通知显示，甚至间接影响消息回调的触发
• 后台执行限制：系统对后台应用的广播接收器、服务启动做了严格管控，若消息处理依赖未适配的后台逻辑，会被系统阻断

另外要确认：你发送的是纯数据消息（无notification字段），如果消息中混入该字段，会被系统判定为通知消息，后台时不会触发onMessageReceived，而是直接显示系统通知。

具体解决方案 #

1. 强制创建通知渠道（Oreo+） #

在应用启动阶段（比如Application的onCreate方法）添加渠道创建逻辑，确保通知能正常弹出：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    NotificationChannel chatChannel = new NotificationChannel(
        "xmpp_chat_channel", // 自定义渠道ID
        "离线聊天通知", // 渠道名称，用户可见
        NotificationManager.IMPORTANCE_HIGH // 设置高优先级，保证后台通知能弹出
    );
    chatChannel.setDescription("接收XMPP离线状态下的聊天消息通知");
    NotificationManager notificationManager = getSystemService(NotificationManager.class);
    notificationManager.createNotificationChannel(chatChannel);
}

2. 确认FCM接收器配置正确 #

检查AndroidManifest.xml中的FCM接收器配置，确保权限和意图过滤规则无误：

<receiver
    android:name="com.google.firebase.messaging.FirebaseMessagingReceiver"
    android:exported="true"
    android:permission="com.google.android.c2dm.permission.SEND">
    <intent-filter>
        <action android:name="com.google.android.c2dm.intent.RECEIVE" />
        <action android:name="com.google.android.c2dm.intent.REGISTRATION" />
        <category android:name="${applicationId}" />
    </intent-filter>
</receiver>

这是FCM消息能被应用正常接收的基础配置，不能遗漏或错误修改。

3. 验证数据消息格式 #

确保发送的是纯数据消息，示例JSON格式如下：

{
  "to": "目标设备的FCM Token",
  "data": {
    "title": "新聊天消息",
    "content": "XX给你发了一条消息",
    "chat_id": "1001",
    "sender_id": "2002"
  }
}

绝对不能包含notification字段，否则Oreo后台时系统会直接接管通知展示，不会触发onMessageReceived。

4. 适配后台服务启动限制 #

如果onMessageReceived中需要启动服务处理消息，Oreo+下不能直接调用startService，必须使用startForegroundService，且服务启动后5秒内要调用startForeground绑定通知：

// 在onMessageReceived中启动服务的逻辑
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    startForegroundService(new Intent(this, ChatMessageProcessService.class));
} else {
    startService(new Intent(this, ChatMessageProcessService.class));
}

然后在ChatMessageProcessService的onCreate方法中绑定前台通知：

@Override
public void onCreate() {
    super.onCreate();
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        Notification foregroundNotification = new NotificationCompat.Builder(this, "xmpp_chat_channel")
                .setContentTitle("处理离线消息")
                .setContentText("正在接收并处理聊天消息")
                .setSmallIcon(R.drawable.ic_chat_notification)
                .build();
        startForeground(100, foregroundNotification);
    }
}

额外排查点 #

• 检查应用是否被系统开启了「电池优化」或「后台限制」，可以引导用户关闭对应设置，确保FCM推送不受系统管控
• 测试时尽量使用真实设备，部分模拟器对Oreo版本的FCM推送支持存在兼容性问题

内容的提问来源于stack exchange，提问作者Atul O Holic