Android 11及以上，如何通过已知DocumentFile Uri获取外部存储持久访问权限？

Android的存储权限机制（尤其是Android 10及以上的分区存储）不支持直接通过文件路径请求特定文件的持久访问权限——系统要求用户通过明确的交互选择文件/目录来授予权限，这是为了保护用户隐私和存储安全。不过你可以通过以下几种更精准的方案优化体验，避免用户选错文件：

1. 用ACTION_OPEN_DOCUMENT缩小选择范围 #

虽然仍需用户操作，但可以通过Intent参数限定可选范围，引导用户快速定位目标文件：

• 指定文件MIME类型，过滤无关文件
• 设置对话框标题，明确提示需要选择的文件名
• Android 10及以上可通过EXTRA_INITIAL_URI直接跳转到目标文件所在目录

代码示例：

val targetFile = File("/storage/emulated/0/Documents/target.pdf")
val targetDirUri = DocumentsContract.buildDocumentUriUsingTree(
    MediaStore.getExternalStorageUri("primary"),
    DocumentsContract.getTreeDocumentId(targetFile.parentFile!!.toUri())
)

val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
    type = "application/pdf" // 匹配目标文件类型
    putExtra(Intent.EXTRA_TITLE, "请选择文件：${targetFile.name}")
    putExtra(DocumentsContract.EXTRA_INITIAL_URI, targetDirUri)
    addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION)
}

startActivityForResult(intent, REQUEST_CODE_OPEN_DOC)

在回调中检查返回Uri对应的文件名，若不匹配则提示用户重新选择。

2. 媒体文件通过MediaStore获取Uri（无持久权限） #

如果目标是图片、视频、音频等媒体文件，可通过MediaStore查询获取对应Uri，但这种方式无法获得持久权限，App重启后需重新请求：

fun getMediaUriFromPath(context: Context, path: String): Uri? {
    val projection = arrayOf(MediaStore.MediaColumns._ID)
    val selection = "${MediaStore.MediaColumns.DATA} = ?"
    val selectionArgs = arrayOf(path)
    val cursor = context.contentResolver.query(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI, // 根据文件类型替换对应Uri
        projection,
        selection,
        selectionArgs,
        null
    )
    return cursor?.let {
        if (it.moveToFirst()) {
            val id = it.getLong(it.getColumnIndexOrThrow(MediaStore.MediaColumns._ID))
            Uri.withAppendedPath(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id.toString())
        } else null
    }?.also { cursor.close() }
}

注意：Android 10+分区存储下，DATA字段可能不再返回真实路径，此方法可能失效。

3. 请求目录权限后自动定位文件 #

通过ACTION_OPEN_DOCUMENT_TREE请求目标文件所在目录的持久权限，后续可通过DocumentTree自动遍历找到目标文件，无需重复让用户选择：

• 引导用户选择目标文件的父目录
• 调用takePersistableUriPermission保存目录权限
• 后续通过DocumentFile遍历目录定位目标文件

代码示例：

// 请求目录权限
val intent = Intent(Intent.ACTION_OPEN_DOCUMENT_TREE).apply {
    putExtra(DocumentsContract.EXTRA_INITIAL_URI, targetDirUri) // 直接跳转到目标目录
    addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION)
}

// 拿到目录Uri后，遍历找到目标文件
fun findTargetFile(treeUri: Uri, targetFileName: String): DocumentFile? {
    val treeDoc = DocumentFile.fromTreeUri(context, treeUri)
    return treeDoc?.listFiles()?.find { it.name == targetFileName }
}

这种方式只需用户授权一次目录，后续即可自动定位文件，体验更流畅。

关键限制说明 #

• Android系统不允许绕过用户交互直接授予特定文件的持久权限，所有持久权限必须由用户通过系统选择界面明确授予
• 非媒体文件无法直接通过路径转换为可持久授权的Uri，必须依赖用户选择文件或其所在目录

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