Targeting S+(31及以上)PendingIntent需指定FLAG_IMMUTABLE/MUTABLE 三星设备仍崩溃求解

排查思路 #

• 先获取三星设备的完整崩溃堆栈，确认报错根源：部分三星定制ROM对Android 12+的PendingIntent校验规则比原生AOSP更严格，你自己的Pixel 3运行正常不代表所有场景都合规。如果堆栈指向IllegalArgumentException: You must either specify FLAG_IMMUTABLE or FLAG_MUTABLE，优先确认崩溃的PendingIntent生成方是业务代码、第三方SDK还是依赖库。
• 核查WorkManager升级后的配套配置：升级WorkManager到2.7.0的前提是compileSdkVersion必须升到31及以上，否则库内部的PendingIntent适配逻辑不会生效。同时WorkManager升级只修复库自身的PendingIntent问题，你自定义Worker内部的PendingIntent、其他业务/第三方SDK生成的PendingIntent不在修复范围内。
• 全量扫描PendingIntent生成场景：除了你自己修改的业务代码，重点排查推送、闹钟、桌面小组件、分享、第三方统计类SDK的版本，多数老旧版本SDK内部生成PendingIntent时不会指定可变/不可变标记，这部分逻辑你无法通过修改自有代码覆盖，是三星机型上崩溃的高发原因。

可落地解决方案 #

• 修正PendingIntent标记配置：如果你的业务场景中PendingIntent需要被外部修改内容（比如接收系统广播回调、和推送服务交互需要修改Intent extra），不能强制加FLAG_IMMUTABLE，必须按版本适配：

int pendingFlag;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
    // 需要修改内容用FLAG_MUTABLE，不需要修改用FLAG_IMMUTABLE
    pendingFlag = needModifyPendingIntent ? PendingIntent.FLAG_MUTABLE : PendingIntent.FLAG_IMMUTABLE;
} else {
    pendingFlag = 你的原有标记;
}
PendingIntent.getXXX(context, requestCode, intent, pendingFlag | 其他原有标记);

• 第三方SDK适配：将所有用到的第三方SDK升级到官方宣称适配Android 12的版本，若存在无法升级的老旧SDK，可临时用反射Hook PendingIntent的getActivty/getService/getBroadcast等方法，对未指定可变标记的请求自动追加对应标记。
• 专项验证：通过云测平台的三星Android 12+机型做全量功能遍历，或者找实体机调试复现，定位触发崩溃的具体路径。

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