Kotlin Android应用后台状态下如何正确接收通知PendingIntent传递的Intent

开发者阿泽

2026-9-25

问题根因&解决方案

1. 最直接的问题：普通通知点击事件未绑定自定义Intent

你当前通知构建代码中setContentIntent(pendingIntent)是被注释状态，系统默认点击通知只会触发主启动页的默认Intent（也就是你调试拿到的ACTION_MAIN启动Intent），仅setFullScreenIntent只有来电等高优先级场景下系统才会主动触发，普通通知点击完全依赖setContentIntent配置的自定义PendingIntent。

2. 冷启动场景逻辑缺失

你仅在onNewIntent中处理了Intent跳转逻辑，当应用完全在后台被系统回收、点击通知冷启动时，系统不会回调onNewIntent，自定义Intent会直接传入onCreate的参数中，这部分场景你目前没有覆盖。

3. TaskStackBuilder配置无效

你创建了TaskStackBuilder但未使用它生成PendingIntent，若需要保持应用返回栈逻辑，应该用栈构建器生成PendingIntent，而非直接传单Activity Intent。

修改后的代码示例

NotificationService.kt 修改部分

val tapResultIntent = Intent(applicationContext, MainActivity::class.java).apply {
    // 确保action不为空，避免走默认启动逻辑
    action = intent?.action ?: return@apply
    // 补充所有需要传递的参数
    putExtra(INCOMING_CALL_INVITE, intent?.getParcelableExtra(INCOMING_CALL_INVITE))
    putExtra(CALLER_ID, intent?.getStringExtra(CALLER_ID))
    putExtra(CALLER_ID_NUMBER, intent?.getStringExtra(CALLER_ID_NUMBER))
    putExtra(INCOMING_CALL_NOTIFICATION_ID, NOTIFICATION_ID)
    addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP or Intent.FLAG_ACTIVITY_CLEAR_TOP)
}

val stackBuilder = TaskStackBuilder.create(applicationContext).apply {
    addParentStack(MainActivity::class.java)
    addNextIntent(tapResultIntent)
}

// 用TaskStackBuilder生成PendingIntent
val pendingIntent: PendingIntent = stackBuilder.getPendingIntent(
    NOTIFICATION_ID,
    PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE
)

val notificationBuilder = Notification.Builder(applicationContext, CHANNEL_ID!!)
    .setContentTitle(notificationTitle)
    .setContentText(notificationBody)
    .setContentIntent(pendingIntent) // 取消该注释，绑定普通点击事件
    .setShowWhen(true)
    .setSmallIcon(notificationIcon!!)
    .setChannelId(CHANNEL_ID)
    .setCategory(Notification.CATEGORY_MISSED_CALL)
    .setAutoCancel(true)
    .setOngoing(false)
    .setColor(Color.rgb(214, 10, 37))
    .setFullScreenIntent(pendingIntent, true)
notificationManager.notify(NOTIFICATION_ID, notificationBuilder.build())

MainActivity.kt 修改部分

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 原有初始化逻辑保持不变
    // 新增：处理冷启动场景的Intent
    handleIntent(intent)
}

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    setIntent(intent)
    handleIntent(intent)
}

// 抽取公共Intent处理逻辑，避免重复代码
private fun handleIntent(intent: Intent?) {
    intent ?: return
    when (intent.action) {
        ACTION_MISSED_CALL, ACTION_NEW_VOICEMAIL -> handleNewNotification(intent)
        else -> handleIncomingCallIntent(intent)
    }
}

额外排查点

如果修改后仍有问题，可确认：

不同动作的通知使用不同的NOTIFICATION_ID作为PendingIntent的requestCode，避免系统复用旧的PendingIntent覆盖自定义参数
MainActivity的launchMode保持singleTop即可，无需修改为singleTask避免返回栈异常

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