Android应用位置权限请求弹窗未显示问题求助

以下是针对权限弹窗不显示问题的排查点和修复方案：

1. 确保清单文件已声明权限 #

系统不会处理未在AndroidManifest.xml中声明的权限请求，必须添加以下权限：

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<!-- Android 10（API 29）及以上需添加后台位置权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

2. 调整权限请求时机 #

在onCreate中直接请求权限可能因Activity未完全初始化或系统拦截导致弹窗不显示，建议延迟请求或通过用户交互触发：

override fun onCreate(savedInstanceState: Bundle?) {
    WindowCompat.setDecorFitsSystemWindows(window, true)
    super.onCreate(savedInstanceState)

    permissionLauncher = registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()){ permissions ->
        islocationpermissiongranted = permissions[Manifest.permission.ACCESS_FINE_LOCATION] ?: islocationpermissiongranted
        backgroundlocationpermission = permissions[Manifest.permission.ACCESS_BACKGROUND_LOCATION] ?: backgroundlocationpermission
    }

    // 延迟1秒请求，或绑定到按钮点击等用户交互事件
    Handler(Looper.getMainLooper()).postDelayed({
        requestpermission()
    }, 1000)
}

3. 遵循后台权限请求规则 #

Android 10+要求必须先获取前台位置权限（ACCESS_FINE_LOCATION/ACCESS_COARSE_LOCATION），才能请求后台位置权限，分两步请求避免弹窗被忽略：

private fun requestpermission(){
    islocationpermissiongranted = ContextCompat.checkSelfPermission(
        this, Manifest.permission.ACCESS_FINE_LOCATION
    ) == PackageManager.PERMISSION_GRANTED

    backgroundlocationpermission = ContextCompat.checkSelfPermission(
        this, Manifest.permission.ACCESS_BACKGROUND_LOCATION
    ) == PackageManager.PERMISSION_GRANTED

    if(!islocationpermissiongranted){
        // 先请求前台位置权限
        permissionLauncher.launch(arrayOf(Manifest.permission.ACCESS_FINE_LOCATION))
    } else if(!backgroundlocationpermission){
        // 前台权限已授权，再请求后台权限
        permissionLauncher.launch(arrayOf(Manifest.permission.ACCESS_BACKGROUND_LOCATION))
    }
}

4. 处理权限永久拒绝情况 #

若用户之前拒绝权限并勾选「不再询问」，系统不会弹出弹窗，需引导用户前往应用设置开启：

permissionLauncher = registerForActivityResult(ActivityResultContracts.RequestMultiplePermissions()){ permissions ->
    permissions.entries.forEach { (permission, granted) ->
        when(permission){
            Manifest.permission.ACCESS_FINE_LOCATION -> {
                islocationpermissiongranted = granted
                if(!granted && !shouldShowRequestPermissionRationale(permission)){
                    // 引导至应用设置页
                    startActivity(Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
                        data = Uri.fromParts("package", packageName, null)
                    })
                }
            }
            Manifest.permission.ACCESS_BACKGROUND_LOCATION -> {
                backgroundlocationpermission = granted
                if(!granted && !shouldShowRequestPermissionRationale(permission)){
                    startActivity(Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS).apply {
                        data = Uri.fromParts("package", packageName, null)
                    })
                }
            }
        }
    }
}

5. 检查targetSdkVersion配置 #

若targetSdkVersion低于29，系统不会识别ACCESS_BACKGROUND_LOCATION权限，需在build.gradle中设置正确版本：

android {
    defaultConfig {
        targetSdkVersion 34 // 或更高版本
    }
}

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