Android 13 POST_NOTIFICATIONS权限请求弹窗不显示问题求助

问题现象 #

• Android 13（API 33，TIRAMISU）及以上版本中，直接请求POST_NOTIFICATIONS权限时，权限弹窗不弹出，registerForActivityResult回调直接返回false，首次打开应用且未拒绝过权限的场景下无日志输出。
• 若在请求权限前先调用创建通知渠道的方法，权限弹窗可正常弹出，回调能返回正确的权限授予状态。

相关代码 #

AndroidManifest.xml #

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

Fragment 原代码 #

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    requestPermissionLauncher =
        registerForActivityResult(ActivityResultContracts.RequestPermission()) {
            if (it) {
                LogUtil.d(TAG, "Grant POST_NOTIFICATION permission")
            } else {
                LogUtil.d(TAG, "Denied POST_NOTIFICATION permission")
            }
        }
}

@RequiresApi(Build.VERSION_CODES.TIRAMISU)
override fun onResume() {
    super.onResume()
    if (ContextCompat.checkSelfPermission(
            activity!!.applicationContext,
            Manifest.permission.POST_NOTIFICATIONS,
        ) == PackageManager.PERMISSION_DENIED
    ) {
        requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
    }
}

通知渠道创建代码 #

private fun createNotificationChannel() {
    val channel = NotificationChannel(
        CHANNEL_ID,
        "Important Notification Channel",
        NotificationManager.IMPORTANCE_HIGH,
    ).apply {
        description = "This notification contains important announcement, etc."
    }
    notificationManager.createNotificationChannel(channel)
}

问题原因 #

Android 13的权限设计中，POST_NOTIFICATIONS权限与通知渠道强关联：系统要求应用必须至少创建一个有效的通知渠道，才会触发权限请求弹窗。若未创建渠道，系统会默认判定应用无发送通知的需求，直接静默拒绝权限请求，不会弹出交互弹窗。

解决方案 #

1. 先创建通知渠道，再请求权限 #

无论是否立即需要发送通知，在请求POST_NOTIFICATIONS权限前，必须确保已创建至少一个通知渠道。可在应用启动阶段（如Application的onCreate、Fragment的onViewCreated）提前创建，重复调用createNotificationChannel不会产生问题（系统会自动跳过已存在的渠道）。

2. 优化权限请求时机 #

避免在onResume中自动触发权限请求（每次页面恢复都会执行，易引起用户反感），建议由用户主动操作触发（如点击“开启通知”按钮），或在应用首次启动时请求。

3. 完善权限拒绝后的处理逻辑 #

当权限被拒绝时，可引导用户前往应用设置手动开启权限，提升用户体验。

修改后的示例代码 #

private lateinit var requestPermissionLauncher: ActivityResultLauncher<String>

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // 初始化权限请求Launcher
    requestPermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
        if (granted) {
            LogUtil.d(TAG, "POST_NOTIFICATIONS权限已授予")
        } else {
            LogUtil.d(TAG, "POST_NOTIFICATIONS权限已拒绝")
            // 引导用户前往设置开启权限
            showPermissionGuideDialog()
        }
    }

    // 提前创建通知渠道（Android 8.0及以上需要）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
        createNotificationChannel()
    }

    // 绑定用户触发权限请求的按钮
    binding.btnEnableNotification.setOnClickListener {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
            requestNotificationPermission()
        }
    }
}

@RequiresApi(Build.VERSION_CODES.TIRAMISU)
private fun requestNotificationPermission() {
    if (ContextCompat.checkSelfPermission(
            requireContext(),
            Manifest.permission.POST_NOTIFICATIONS
        ) == PackageManager.PERMISSION_DENIED
    ) {
        requestPermissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
    }
}

private fun createNotificationChannel() {
    val channel = NotificationChannel(
        CHANNEL_ID,
        "重要通知渠道",
        NotificationManager.IMPORTANCE_HIGH
    ).apply {
        description = "用于接收应用重要公告与提醒"
    }
    val notificationManager = requireContext().getSystemService(NotificationManager::class.java)
    notificationManager.createNotificationChannel(channel)
}

private fun showPermissionGuideDialog() {
    AlertDialog.Builder(requireContext())
        .setTitle("通知权限未开启")
        .setMessage("需要开启通知权限才能接收应用提醒，请前往设置开启")
        .setPositiveButton("去设置") { _, _ ->
            val intent = Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
                data = Uri.fromParts("package", requireContext().packageName, null)
            }
            startActivity(intent)
        }
        .setNegativeButton("取消", null)
        .show()
}

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