Firebase Cloud Messaging自定义布局通知在后台/杀死状态失效

问题根源 #

FCM推送分为两种核心消息类型：

• 通知消息（带notification字段）：应用处于后台/杀死状态时，系统会直接接管通知展示，使用默认样式，不会触发你的自定义通知构建逻辑。
• 数据消息（仅包含data字段）：无论应用处于前台、后台还是被杀死状态，消息都会传递到你的FirebaseMessagingService，由你完全控制通知的构建流程。

你的问题正是因为使用了通知消息，后台状态下系统跳过了自定义逻辑，导致自定义布局无法生效。

解决方案步骤 #

1. 切换为数据消息推送

调整推送的Payload结构，移除notification字段，仅保留data字段，示例如下：

{
  "to": "目标设备令牌",
  "data": {
    "title": "自定义通知标题",
    "content": "自定义通知内容",
    "collapse_key": "your_collapse_key",
    // 其他业务所需的自定义字段
  }
}

2. 在FirebaseMessagingService中统一构建自定义通知

创建继承FirebaseMessagingService的类，在onMessageReceived方法中完成自定义通知的构建：

public class CustomFirebaseMessagingService extends FirebaseMessagingService {
    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        // 从data中提取推送内容
        String title = remoteMessage.getData().get("title");
        String content = remoteMessage.getData().get("content");

        // 加载折叠状态的自定义布局
        RemoteViews collapsedLayout = new RemoteViews(getPackageName(), R.layout.notification_collapsed);
        collapsedLayout.setTextViewText(R.id.tv_collapsed_title, title);
        collapsedLayout.setTextViewText(R.id.tv_collapsed_content, content);

        // 加载展开状态的自定义布局
        RemoteViews expandedLayout = new RemoteViews(getPackageName(), R.layout.notification_expanded);
        expandedLayout.setTextViewText(R.id.tv_expanded_title, title);
        expandedLayout.setTextViewText(R.id.tv_expanded_content, content);

        // 创建通知渠道（Android 8.0及以上必需）
        String channelId = "custom_notification_channel";
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel channel = new NotificationChannel(channelId,
                    "自定义通知渠道",
                    NotificationManager.IMPORTANCE_DEFAULT);
            NotificationManager notificationManager = getSystemService(NotificationManager.class);
            notificationManager.createNotificationChannel(channel);
        }

        // 构建并展示通知
        NotificationCompat.Builder notificationBuilder = new NotificationCompat.Builder(this, channelId)
                .setSmallIcon(R.drawable.ic_notification_icon)
                .setCustomContentView(collapsedLayout)
                .setCustomBigContentView(expandedLayout)
                .setPriority(NotificationCompat.PRIORITY_DEFAULT);

        NotificationManagerCompat.from(this).notify(1, notificationBuilder.build());
    }
}

3. 注意RemoteViews的使用限制

• 仅支持系统原生基础控件（如TextView、ImageView等），不能使用自定义View。
• 布局尺寸需适配不同设备，避免内容被截断。
• 确保布局中控件ID与代码中引用的ID完全一致。

4. 适配Android 13+权限

在AndroidManifest.xml中添加通知权限：

<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

同时在代码中动态申请该权限，确保通知能正常展示。

验证 #

推送调整后的消息后，无论应用处于前台、后台还是被杀死状态，都会触发onMessageReceived方法，展示你配置的自定义折叠/展开布局通知。

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