Android Kotlin应用中PermissionX权限请求的正确用法及问题解决

1. 当前PermissionX使用方式的正确性 #

你的核心代码逻辑符合PermissionX的官方规范，但存在几个细节疏漏，这是导致权限对话框不显示、直接判定拒绝的主要原因：

• 未确认AndroidManifest.xml是否完整声明目标权限
• 可能在Activity/Fragment生命周期不正确的时机调用权限请求（比如onCreate()早期阶段）
• 未适配Android版本变更后的权限规则（如Android 13+的存储权限调整）

2. 修正方案与全场景覆盖 #

第一步：补全权限声明 #

先在AndroidManifest.xml中添加适配多版本的权限声明，这是权限请求生效的基础：

<!-- 相机权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- Android 12及以下的存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13+的媒体存储权限（替代原READ_EXTERNAL_STORAGE） -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

第二步：修正权限请求代码 #

将权限请求放在**用户主动触发的事件（如按钮点击）**或Activity的onResume()中（避免生命周期过早调用导致弹窗异常），同时优化回调逻辑以覆盖更多场景：

// 示例：绑定按钮点击事件触发权限请求
binding.btnRequestPermissions.setOnClickListener {
    val storagePermission = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        android.Manifest.permission.READ_MEDIA_IMAGES
    } else {
        android.Manifest.permission.READ_EXTERNAL_STORAGE
    }

    PermissionX.init(this@MainActivity)
        .permissions(storagePermission, android.Manifest.permission.CAMERA)
        .onExplainRequestReason { scope, deniedList ->
            // 仅对需要解释的权限弹窗（PermissionX自动过滤已永久拒绝的权限）
            scope.showRequestReasonDialog(
                deniedList,
                "需要相机权限拍摄照片、存储权限读取本地图片，才能正常使用功能",
                "同意授权",
                "暂不授权"
            )
        }
        .onForwardToSettings { scope, deniedList ->
            // 用户勾选"不再询问"后，引导至系统设置页开启权限
            scope.showForwardToSettingsDialog(
                deniedList,
                "您已拒绝权限并勾选不再询问，请前往设置页手动开启",
                "去设置",
                "取消"
            )
        }
        .request { allGranted, grantedList, deniedList ->
            when {
                allGranted -> {
                    Toast.makeText(this@MainActivity, "所有权限已授权", Toast.LENGTH_SHORT).show()
                    // 权限全部通过后执行业务逻辑
                    startTargetTask()
                }
                grantedList.isNotEmpty() -> {
                    val grantedStr = grantedList.joinToString(", ") { it.split(".").last() }
                    Toast.makeText(this@MainActivity, "已授权权限：$grantedStr，部分功能可正常使用", Toast.LENGTH_SHORT).show()
                    // 针对性处理部分授权场景（比如仅相机权限可用时，开启拍摄功能）
                    if (grantedList.contains(android.Manifest.permission.CAMERA)) {
                        enableCameraFunction()
                    }
                }
                else -> {
                    val deniedStr = deniedList.joinToString(", ") { it.split(".").last() }
                    Toast.makeText(this@MainActivity, "已拒绝权限：$deniedStr，相关功能无法使用", Toast.LENGTH_SHORT).show()
                }
            }
        }
}

第三步：确保全场景正常执行 #

• 部分授权处理：不要仅依赖allGranted判断，通过grantedList识别已授权的权限，针对性开放可用功能
• 永久拒绝后返回处理：用户从设置页返回后，在onResume()中重新检查权限状态，及时更新UI或业务逻辑：

override fun onResume() {
    super.onResume()
    val cameraGranted = PermissionX.isGranted(this@MainActivity, android.Manifest.permission.CAMERA)
    val storageGranted = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
        PermissionX.isGranted(this@MainActivity, android.Manifest.permission.READ_MEDIA_IMAGES)
    } else {
        PermissionX.isGranted(this@MainActivity, android.Manifest.permission.READ_EXTERNAL_STORAGE)
    }

    if (cameraGranted && storageGranted) {
        // 权限已全部授权，更新UI或恢复业务逻辑
        updateUIForFullPermission()
    }
}

• 生命周期时机选择：避免在onCreate()、onStart()阶段直接调用权限请求，优先放在用户主动触发的操作（如按钮点击），确保Activity已完全可见，弹窗能正常显示

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