AlarmManager推送通知失效排查及Builder过时问题咨询

嘿，我来帮你拆解这个问题！先给你吃个定心丸：NotificationCompat.Builder(context) 过时的警告本身不会直接导致通知失效，但这个过时提示背后的API变化，可能是你通知不显示的核心原因之一，咱们一步步来分析：

一、先解决Builder过时的问题（顺带修复潜在的通知显示障碍） #

从Android 8.0（API 26）开始，Google要求所有通知必须关联一个通知渠道，旧的Builder(context)构造方法没有传入渠道ID，在Android O及以上系统中，这类通知会被系统拦截不显示。所以你需要替换成带渠道ID的构造方法，同时提前创建好通知渠道：

1. 创建通知渠道（建议在Application初始化或首次发送通知前执行） #

private void createNotificationChannel(Context context) {
    // 仅Android O及以上需要创建渠道
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        CharSequence name = "投票提醒渠道";
        String description = "用于推送投票相关的提醒通知";
        int importance = NotificationManager.IMPORTANCE_DEFAULT;
        NotificationChannel channel = new NotificationChannel("VOTE_CHANNEL_ID", name, importance);
        channel.setDescription(description);
        
        // 注册渠道到系统
        NotificationManager notificationManager = context.getSystemService(NotificationManager.class);
        notificationManager.createNotificationChannel(channel);
    }
}

2. 使用新的Builder构造方法 #

// 替换过时的写法
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context, "VOTE_CHANNEL_ID")
        .setSmallIcon(R.drawable.ic_notification) // 必须设置！没有小图标通知不会显示
        .setContentTitle("投票即将开始")
        .setContentText("请及时参与投票哦")
        .setPriority(NotificationCompat.PRIORITY_DEFAULT);

二、排查通知不显示的其他核心原因 #

除了渠道问题，结合你提到的AlertReceiver、Manifest配置等，还有这些常见坑：

• 广播接收器未正确注册
  如果是静态注册AlertReceiver，必须在AndroidManifest.xml中声明，并且注意Android 12+对广播接收器的限制：

  <receiver
      android:name=".AlertReceiver"
      android:exported="true"> <!-- Android 12+ 需要设置exported属性 -->
      <intent-filter>
          <action android:name="android.intent.action.BOOT_COMPLETED" /> <!-- 如果需要开机自启的话 -->
      </intent-filter>
  </receiver>
  

  如果是动态注册，要确保在Activity或Service中正确调用registerReceiver()，且未提前注销。

• AlarmManager的PendingIntent配置错误
  确保PendingIntent的flag符合Android版本要求，Android 12+推荐使用FLAG_IMMUTABLE（如果不需要修改Intent内容）：

  Intent intent = new Intent(context, AlertReceiver.class);
  PendingIntent pendingIntent = PendingIntent.getBroadcast(
          context,
          0,
          intent,
          PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE // Android 12+ 必须加IMMUTABLE或MUTABLE
  );
  

  另外，Alarm的触发类型要选对：如果需要唤醒休眠的设备，用AlarmManager.RTC_WAKEUP而非ELAPSED_REALTIME。

• 通知权限未开启
  Android 13+需要单独申请POST_NOTIFICATIONS权限：

  1. 在Manifest中添加权限：

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

  2. 动态申请权限：

     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
         if (ContextCompat.checkSelfPermission(context, Manifest.permission.POST_NOTIFICATIONS) != PackageManager.PERMISSION_GRANTED) {
             // 通过ActivityResultLauncher发起权限申请
             ActivityResultLauncher<String> requestPermissionLauncher = registerForActivityResult(
                     new ActivityResultContracts.RequestPermission(),
                     isGranted -> {
                         if (isGranted) {
                             // 权限已授予，可发送通知
                         }
                     });
             requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS);
         }
     }
     

  同时检查设备的应用通知开关是否被关闭。

• AlertReceiver中未正确发送通知
  确保在onReceive()方法中，你调用了NotificationManager.notify()来发送通知：

  @Override
  public void onReceive(Context context, Intent intent) {
      createNotificationChannel(context); // 确保渠道已创建
      NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(context, "VOTE_CHANNEL_ID")
              .setSmallIcon(R.drawable.ic_notification)
              .setContentTitle("投票提醒")
              .setContentText("该去投票啦！");
      
      NotificationManager notificationManager = context.getSystemService(NotificationManager.class);
      notificationManager.notify(1, mBuilder.build()); // 1是通知ID，确保唯一
  }
  

三、总结排查步骤 #

1. 先替换Builder为带渠道ID的构造方法，确保通知渠道已创建；
2. 检查Manifest中广播接收器的注册是否正确；
3. 验证AlarmManager的PendingIntent flag和触发类型是否符合版本要求；
4. 确认通知权限已开启（尤其是Android 13+）；
5. 检查AlertReceiver中是否正确调用notify()发送通知，且设置了必填的小图标。

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