Android 14中MANAGE_EXTERNAL_STORAGE权限失效问题求助

核心原因 #

Android 14（API 34）对MANAGE_EXTERNAL_STORAGE这个特殊权限的请求流程做了强制修改：

• 不再支持通过ActivityResultContracts.RequestPermission()合约直接发起权限请求，调用后系统不会弹出权限申请对话框，直接返回false。
• 该权限属于系统级特殊权限，必须引导用户到应用的系统设置页面手动开启，而非普通危险权限的弹窗请求模式。

解决步骤 #

1. 替换权限请求合约 #

使用ActivityResultContracts.StartActivityForResult()合约，创建跳转到应用权限设置页面的Intent：

val permissionLauncher = rememberLauncherForActivityResult(
    contract = ActivityResultContracts.StartActivityForResult()
) { result ->
    // 从设置返回后，检查权限是否已开启
    val hasPermission = Environment.isExternalStorageManager()
    if (hasPermission) {
        onPermissionGrant()
    } else {
        onPermissionDenied()
    }
}

LaunchedEffect(key1 = Unit) {
    val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION).apply {
        data = Uri.parse("package:${context.packageName}")
    }
    permissionLauncher.launch(intent)
}

2. 确认清单配置 #

确保AndroidManifest.xml中已正确声明权限：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />
<application ...>
    <!-- 其他配置 -->
</application>

如果你的应用需要访问其他应用的文件，还需添加queries标签（根据需求调整）：

<queries>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:mimeType="*/*" />
    </intent>
</queries>

3. 权限状态检查优化 #

在进入权限请求流程前，先检查当前是否已拥有权限，避免无效跳转：

LaunchedEffect(key1 = Unit) {
    if (Environment.isExternalStorageManager()) {
        onPermissionGrant()
    } else {
        // 发起跳转设置页面请求
        val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION).apply {
            data = Uri.parse("package:${context.packageName}")
        }
        permissionLauncher.launch(intent)
    }
}

内容的提问来源于stack exchange，提问作者Thái Quốc Toàn