KitKat 4.4.2版本Firebase推送通知不显示问题求助

看起来你遇到了Firebase推送通知的兼容性问题——通知在Lollipop及以上正常，但KitKat 4.4.2上完全不显示。结合你提供的代码，我梳理了几个关键问题点和修复方案：

1. 通知图标兼容性问题 #

KitKat（API 19）对通知图标有严格要求：必须是纯白色、透明背景的矢量图或png图，否则系统会自动将图标替换为灰色方块，导致看起来通知没显示。

你的代码里用了应用启动图标R.mipmap.ic_launcher，大概率不符合这个要求：

// 替换前
notificationBuilder.setSmallIcon(R.mipmap.ic_launcher);

// 替换后：使用专门的通知图标
notificationBuilder.setSmallIcon(R.drawable.ic_notification);

可以用Android Studio的「Image Asset」工具生成符合规范的通知图标，选择「Notification Icon」类型即可。

2. PendingIntent Flag不兼容 #

你使用的PendingIntent.FLAG_ONE_SHOT在KitKat下可能导致PendingIntent无法正确触发页面跳转，甚至影响通知的显示。建议替换为兼容性更好的Flag：

// 替换原来的PendingIntent初始化代码
int pendingIntentFlags;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    pendingIntentFlags = PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE;
} else {
    pendingIntentFlags = PendingIntent.FLAG_UPDATE_CURRENT;
}
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, pendingIntentFlags);

3. 通知逻辑重复冲突 #

你的onMessageReceived方法存在逻辑矛盾：

• 在handleNotification里你写了「后台时交给Firebase自动处理通知」
• 但方法最后又手动构建了一遍通知

这种重复处理会导致KitKat下系统通知和自定义通知冲突，甚至被系统拦截。建议删除onMessageReceived最后那段手动构建通知的代码，让逻辑统一：

// 删除以下这段冗余代码
String title=remoteMessage.getNotification().getTitle();
String message=remoteMessage.getNotification().getBody();
String click_action=remoteMessage.getNotification().getClickAction();
Intent intent=new Intent(click_action);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
PendingIntent pendingIntent=PendingIntent.getActivity(this,0,intent,PendingIntent.FLAG_ONE_SHOT);
NotificationCompat.Builder notificationBuilder=new NotificationCompat.Builder(this);
notificationBuilder.setContentTitle(title);
notificationBuilder.setContentText(message);
notificationBuilder.setSmallIcon(R.mipmap.ic_launcher);
notificationBuilder.setAutoCancel(true);
notificationBuilder.setContentIntent(pendingIntent);
NotificationManager notificationManager=(NotificationManager)getSystemService(Context.NOTIFICATION_SERVICE);
notificationManager.notify(0,notificationBuilder.build());

4. 检查NotificationUtils的实现 #

你调用了NotificationUtils的方法但没提供这个类的代码，需要确保它在KitKat下能正确构建通知：

• 必须用NotificationCompat.Builder而非原生Notification类构建通知
• 确保设置了setSmallIcon、setContentTitle、setContentText、setContentIntent这些KitKat通知的必填字段

5. 调整Firebase推送Payload类型 #

如果你的推送同时包含notification和data字段：

• 后台时系统会自动显示notification字段的内容，data字段会附加到启动的Intent中
• 前台时才会走到onMessageReceived

如果希望完全控制通知逻辑（无论前台后台），建议只发送data payload，不要包含notification字段，这样所有推送都会触发onMessageReceived，由你手动处理通知显示。

修改完成后，在KitKat设备上测试两种场景：

1. App前台时，检查是否能收到广播并播放通知音
2. App后台时，检查通知是否正常显示在系统托盘，点击后能否正确跳转页面

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