锁屏打开通知与通知栏打开通知行为不一致问题求助

嘿，这个锁屏和通知栏点击通知表现不一致的问题我之前也碰到过，大概率是PendingIntent的配置或者Activity启动模式的锅，我给你梳理几个排查方向和解决方案：

1. 检查PendingIntent的Intent Flags配置 #

这是最常见的问题根源！系统在锁屏状态下启动Activity的规则和正常状态略有不同，如果Intent的Flags没设对，就会导致两种场景下Activity的启动行为（比如新建实例/复用实例）不一样。

你需要确保创建PendingIntent时，给Intent设置正确的Flags，同时PendingIntent本身的Flags也要符合要求：

// 跳转到NotificationActivity的Intent
val intent = Intent(this, NotificationActivity::class.java)
// **关键Flags**：确保在新任务栈启动，且如果栈内已有该Activity则复用并清理上方页面
intent.flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP

// 创建PendingIntent，注意Android 12+必须加FLAG_IMMUTABLE
val pendingIntent = PendingIntent.getActivity(
    this,
    0,
    intent,
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)

• FLAG_ACTIVITY_NEW_TASK：因为通知是系统进程触发的，必须加这个Flag才能让Activity在独立任务栈启动
• FLAG_ACTIVITY_CLEAR_TOP：如果栈中已经存在NotificationActivity实例，会把它上方的Activity全部清除，直接复用这个实例，避免重复创建
• FLAG_UPDATE_CURRENT：保证每次更新通知时，Intent的最新数据能生效
• FLAG_IMMUTABLE：Android 12及以上版本强制要求，提升安全性

2. 确认NotificationActivity的启动模式 #

检查AndroidManifest.xml中NotificationActivity的launchMode配置，不合理的启动模式也会导致行为差异：

<activity
    android:name=".NotificationActivity"
    android:launchMode="singleTop"> <!-- 或者根据需求选择合适的模式 -->
</activity>

• 如果设置了singleTask或singleInstance，系统在锁屏下的任务栈处理逻辑可能和正常状态不同，建议先尝试改成singleTop或者默认的standard，看是否解决问题
• 如果你需要特定的启动模式，一定要确保在onNewIntent方法中处理Intent数据（因为复用实例时不会走onCreate）：

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    setIntent(intent) // 更新当前Intent为最新的
    // 在这里处理和onCreate中一样的初始化逻辑，比如解析Intent携带的参数
    processNotificationData(intent)
}

3. 确保锁屏下Activity能正常显示 #

锁屏状态下系统会限制Activity的显示，如果你的NotificationActivity没有配置锁屏显示权限，可能会出现“先解锁才能打开页面”的情况，和通知栏直接打开的表现形成差异。

你可以通过两种方式配置：

• 在AndroidManifest.xml中给Activity添加属性：

<activity
    android:name=".NotificationActivity"
    android:showOnLockScreen="true"
    android:turnScreenOn="true"> <!-- 可选：打开通知时点亮屏幕 -->
</activity>

• 或者在NotificationActivity的onCreate方法中动态设置：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 允许锁屏下显示Activity
    window.addFlags(WindowManager.LayoutParams.FLAG_SHOW_WHEN_LOCKED)
    // 可选：点亮屏幕
    window.addFlags(WindowManager.LayoutParams.FLAG_TURN_SCREEN_ON)
}

4. 完整的通知创建代码示例 #

把上面的配置整合到你的通知创建逻辑中，确保没有遗漏关键步骤（比如Android 8.0+必须配置通知渠道）：

val channelId = "your_app_notification_channel"
val mBuilder = NotificationCompat.Builder(this, channelId)
    .setSmallIcon(R.drawable.notification_icon_background)
    .setContentTitle("Title")
    .setContentText("Content")
    .setPriority(NotificationCompat.PRIORITY_DEFAULT)
    .setContentIntent(pendingIntent) // 绑定刚才创建的PendingIntent
    .setAutoCancel(true) // 点击通知后自动取消通知

val notificationManager = NotificationManagerCompat.from(this)
// Android 8.0+ 创建通知渠道
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
    val channel = NotificationChannel(
        channelId,
        "普通通知",
        NotificationManager.IMPORTANCE_DEFAULT
    )
    notificationManager.createNotificationChannel(channel)
}
// 发送通知
notificationManager.notify(1, mBuilder.build())

按照上面的步骤排查和调整，应该就能解决两种场景下的表现不一致问题啦！

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