Android API 34-ext15下Heads-up通知无法弹窗显示问题求助

通用启用Heads-up通知的核心条件 #

• API26+（Android 8.0）：通知渠道必须设置为IMPORTANCE_HIGH，这是触发Heads-up弹窗的基础；同时通知Builder要搭配PRIORITY_HIGH做低版本兼容
• 权限与系统设置检查：
  • 确认应用的「通知权限」已开启
  • 对应通知渠道的「重要性」没被手动调低（系统或用户可能误改到「中」及以下，直接取消弹窗能力）
  • API34+（Android 14）必看：新增了POST_NOTIFICATIONS运行时权限，必须主动请求，否则通知会被系统拦截，连基础显示都受影响，更别说Heads-up弹窗

针对你代码的补充调整 #

你的代码已经配置了IMPORTANCE_HIGH和PRIORITY_HIGH，但API34+缺了关键的权限步骤：

1. 在AndroidManifest.xml里声明权限：

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

2. 在App启动阶段（比如MainActivity的onCreate）请求权限：

private const val REQUEST_CODE_NOTIFY_PERM = 1001

// 在合适的时机调用
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.POST_NOTIFICATIONS)
        != PackageManager.PERMISSION_GRANTED
    ) {
        ActivityCompat.requestPermissions(
            this,
            arrayOf(Manifest.permission.POST_NOTIFICATIONS),
            REQUEST_CODE_NOTIFY_PERM
        )
    }
}

API34的通知关键变更 #

Android 14（API34）把通知权限升级成了运行时权限，所有应用必须主动请求POST_NOTIFICATIONS才能发送通知。没请求的话，哪怕代码逻辑全对，通知要么被静默拦截，要么只在通知栏显示，根本弹不出Heads-up。

重启模拟器解决问题的原因 #

模拟器偶尔会出现通知服务缓存异常，导致之前配置的通知渠道重要性没生效。重启设备后系统重新加载渠道配置，IMPORTANCE_HIGH的优先级才真正生效，Heads-up弹窗也就正常了。

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