安卓前台首次接收FCM推送无通知显示问题求助

问题现象 #

• 应用前台运行时，能静默接收FCM通知，但通知栏无任何消息/标题显示
• 应用后台/非活跃状态下，通知显示正常，功能可用
• 若先在后台接收过至少一次通知，切换回前台后，推送通知可正常显示

使用的推送Payload（通过AWS Push SNS发送）：

{"GCM":"{ \"notification\": { \"title_loc_key\": \"some_title\", \"body_loc_key\": \"some_description\", \"body_loc_args\": [\"120\"] }, \"priority\": \"high\" }"}

原因分析 #

1. FCM消息机制差异：FCM的notification类型消息，在应用前台时会直接传递到onMessageReceived方法，但系统不会自动弹出通知栏；后台/非活跃状态下，系统会自动处理并显示通知。
2. 通知渠道缺失（Android 8.0+）：Android 8.0及以上版本要求通知必须关联有效通知渠道。后台接收notification消息时，系统会自动创建默认通知渠道；但首次前台接收时，若代码未提前创建渠道，即使在onMessageReceived中处理通知，也无法在通知栏显示。后台接收后渠道已存在，后续前台处理就能正常显示。

解决步骤 #

1. 提前创建通知渠道 #

在App启动时（如Application类的onCreate方法中），主动创建通知渠道，避免依赖系统自动创建：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    String channelId = "your_default_channel_id";
    String channelName = "默认通知渠道";
    String channelDescription = "接收应用推送通知";
    int importance = NotificationManager.IMPORTANCE_DEFAULT;
    
    NotificationChannel channel = new NotificationChannel(channelId, channelName, importance);
    channel.setDescription(channelDescription);
    
    NotificationManager notificationManager = getSystemService(NotificationManager.class);
    notificationManager.createNotificationChannel(channel);
}

2. 前台接收时手动构建并显示通知 #

在FirebaseMessagingService的onMessageReceived方法中，处理notification类型消息，手动构建通知并显示：

@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
    // 提取通知本地化参数
    String titleKey = remoteMessage.getNotification().getTitleLocalizationKey();
    String bodyKey = remoteMessage.getNotification().getBodyLocalizationKey();
    String[] bodyArgs = remoteMessage.getNotification().getBodyLocalizationArgs();
    
    // 解析本地化字符串
    Resources res = getResources();
    String localizedTitle = res.getString(res.getIdentifier(titleKey, "string", getPackageName()));
    String localizedBody = res.getString(res.getIdentifier(bodyKey, "string", getPackageName()), (Object[]) bodyArgs);
    
    // 构建并显示通知
    NotificationCompat.Builder builder = new NotificationCompat.Builder(this, "your_default_channel_id")
            .setSmallIcon(R.drawable.ic_notification)
            .setContentTitle(localizedTitle)
            .setContentText(localizedBody)
            .setPriority(NotificationCompat.PRIORITY_HIGH);
    
    NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
    notificationManager.notify(1, builder.build());
}

3. 改用Data消息（可选，更可控） #

若希望统一前台后台的通知处理逻辑，可将Payload改为仅包含data字段，这样无论App处于什么状态，消息都会传递到onMessageReceived，由你完全控制通知显示：

{"GCM":"{ \"data\": { \"title_loc_key\": \"some_title\", \"body_loc_key\": \"some_description\", \"body_loc_args\": [\"120\"] }, \"priority\": \"high\" }"}

后续在onMessageReceived中解析data字段并构建通知，逻辑同上。

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