Android通知PendingIntent管理与版本适配相关技术疑问

DevOps 小满

2026-7-29

核心实现代码

基础通知构建

val builder = NotificationCompat.Builder(MyApp.appContext, FCM_CHANNEL)
                    .setSmallIcon(R.drawable.noticon)
                    .setLargeIcon(image)
                    .setContentTitle(user?.name)
                    .setPriority(NotificationCompat.PRIORITY_HIGH)
                    .setAutoCancel(true)

带PendingIntent的通知按钮添加

val responseIntent = Intent(MyApp.appContext, ResponseBroadcastReceiver::class.java)
responseIntent.putExtra(ResponseBroadcastReceiver.USER_ID, fromUid)

val flags: Int = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S)
                            PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_ONE_SHOT
                        else
                            PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_ONE_SHOT
                        
val pendingIntent = PendingIntent.getBroadcast(MyApp.appContext, abs(fromUid.hashCode()), responseIntent, flags)

builder.addAction(0, "Reply", pendingIntent)
builder.setContentText("Please respond")

技术问询

由于每个通知都会创建新的PendingIntent，如何查看所有活跃的PendingIntent实例？已知存在35个的上限，超出该上限后会出现什么情况？
为NotificationCompat.Builder设置setAutoCancel(true)后，当通知被消除时是否会自动移除对应的PendingIntent？这正是我想要的效果。
我需要PendingIntent仅触发一次（使用PendingIntent.FLAG_ONE_SHOT）且具备可变性，当前针对不同SDK版本的适配方案是否正确？

问题解答

1. 活跃PendingIntent查看与上限问题

查看活跃实例：Android系统没有公开API直接查看所有活跃PendingIntent，只能通过间接方式排查：比如在创建时自行用全局集合记录实例信息，或者通过adb shell dumpsys activity intents命令查看系统中PendingIntent的相关日志，但输出内容较零散，需要自行筛选。
上限与超出后果：单个应用的PendingIntent实例数量确实存在阈值（不同版本略有差异，35是常见值）。超出上限时，调用PendingIntent.getXXX()会抛出IllegalArgumentException，导致通知按钮无法添加，甚至整个通知构建失败。

2. setAutoCancel(true)与PendingIntent的移除关系

不会自动移除对应的PendingIntent。setAutoCancel(true)仅作用于通知本身：当通知被点击或滑动清除时，系统会自动从通知栏移除该通知，但PendingIntent是独立的系统级对象，只有当它的引用计数降为0（所有使用它的通知销毁、无其他组件持有），或系统内存紧张时才会被回收。如果需要主动释放，需自行关联通知与PendingIntent的对应关系，在通知清除时调用PendingIntent.cancel()手动取消。

3. SDK版本适配方案的正确性

当前适配逻辑存在问题，不符合「仅触发一次+可变性」的需求：

Android 12（API 31）及以上：FLAG_MUTABLE | FLAG_ONE_SHOT的设置是正确的——FLAG_MUTABLE保证PendingIntent可修改，FLAG_ONE_SHOT确保触发一次后失效。
Android 12以下：使用FLAG_UPDATE_CURRENT | FLAG_ONE_SHOT有误。旧版本中PendingIntent默认就是可变的，不需要FLAG_UPDATE_CURRENT；且该flag会让相同requestCode的PendingIntent更新Intent的extra数据，若abs(fromUid.hashCode())产生重复的requestCode，旧通知的按钮触发时会拿到新的user ID，不符合预期。

正确适配逻辑：

val flags: Int = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    PendingIntent.FLAG_MUTABLE or PendingIntent.FLAG_ONE_SHOT
} else {
    PendingIntent.FLAG_ONE_SHOT
}

另外建议避免用fromUid.hashCode()作为requestCode，可结合通知ID等生成更唯一的标识，防止PendingIntent被意外覆盖。

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