API 24设备通知不显示，API 26设备正常，求问题排查

你的代码在API 26+设备上能正常显示通知，但API 24设备不行，我帮你排查几个关键问题：

1. NotificationCompat.Builder构造器的版本兼容问题 #

你当前使用的是带channelId的NotificationCompat.Builder构造器，虽然官方文档说明它支持API 14+，但在API 26以下的系统中，由于不存在通知渠道的概念，部分版本的Support Library可能会因无法识别channelId而拦截通知。

解决方案：分版本创建Builder实例，API 26+使用带渠道ID的构造器，低版本使用无渠道ID的构造器：

NotificationCompat.Builder notificationBuilder;
String channelId = "new_message_channel";
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    // API 26及以上，使用指定渠道的构造器
    notificationBuilder = new NotificationCompat.Builder(this, channelId);
} else {
    // API 25及以下，使用无渠道参数的构造器
    notificationBuilder = new NotificationCompat.Builder(this);
}

2. 通知图标不符合API 21+规范 #

从API 21开始，Android要求通知图标必须是白色剪影+透明背景的样式。你当前使用的ic_person_black_24dp是黑色图标，在浅色通知栏背景下会完全看不见，可能让你误以为通知没有显示。

解决方案：替换为符合要求的通知图标，比如在res目录下创建专门的通知图标资源（通常命名为ic_notification），确保图标为白色剪影样式。

3. PendingIntent Flag的适配（可选，但建议优化） #

虽然API 24中PendingIntent.FLAG_ONE_SHOT是有效的，但在API 23+版本中，建议添加FLAG_IMMUTABLE来提升安全性，同时不影响低版本的功能：

int pendingIntentFlags = PendingIntent.FLAG_ONE_SHOT;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    pendingIntentFlags |= PendingIntent.FLAG_IMMUTABLE;
}
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, pendingIntentFlags);

其他排查点 #

• 检查API 24设备上的应用通知设置，确保没有禁用该应用的通知权限（API 26以下默认允许通知，但用户可能手动关闭）。
• 尝试提高通知优先级：将setPriority(NotificationCompat.PRIORITY_DEFAULT)改为setPriority(NotificationCompat.PRIORITY_HIGH)，部分设备对低优先级通知有显示限制。
• 确认title和messageBody不为空，空内容的通知可能被系统忽略。

修改后的完整代码 #

Intent intent = new Intent(this, TranscriptActivity.class);
intent.putExtra("path", path);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);

// 适配PendingIntent Flag
int pendingIntentFlags = PendingIntent.FLAG_ONE_SHOT;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    pendingIntentFlags |= PendingIntent.FLAG_IMMUTABLE;
}
PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, intent, pendingIntentFlags);

String channelId = "new_message_channel";
Uri defaultSoundUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_NOTIFICATION);

// 分版本创建NotificationCompat.Builder
NotificationCompat.Builder notificationBuilder;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    notificationBuilder = new NotificationCompat.Builder(this, channelId);
} else {
    notificationBuilder = new NotificationCompat.Builder(this);
}

notificationBuilder.setSmallIcon(R.drawable.ic_notification) // 替换为符合规范的通知图标
        .setContentTitle(title)
        .setContentText(messageBody)
        .setAutoCancel(true)
        .setSound(defaultSoundUri)
        .setPriority(NotificationCompat.PRIORITY_DEFAULT)
        .setContentIntent(pendingIntent);

NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);
notificationManager.notify(0, notificationBuilder.build());

另外，你创建通知渠道的代码是正确的，仅在API 26+执行，无需修改。

内容的提问来源于stack exchange，提问作者Joel Robinson-Johnson