如何打开已获取权限的content:// URI及其子文件URI？

核心结论 #

通过OpenDocumentTree获取content://com.android.externalstorage.documents/tree/1234-5678:Android/media/Music的持久权限后，理论上可以直接用applicationContext.contentResolver.openFileDescriptor()打开该树下的子文件URI（如你提到的歌曲文件URI），但需要注意几个关键细节。

容易忽略的关键点 #

• 子URI格式必须正确：手动拼接子URI容易出错，比如树URI的tree/部分和文件路径的对应关系错误。正确的子文件URI应该是从已授权的树URI衍生而来，而非随意硬编码。建议通过DocumentFile API来获取子文件的URI，避免格式问题。
• 权限的针对性：你调用takePersistableUriPermission时仅申请了FLAG_GRANT_READ_URI_PERMISSION，如果后续需要写入子文件，必须在获取权限时同时添加FLAG_GRANT_WRITE_URI_PERMISSION，否则写入操作会失败。
• 权限持久性的边界：持久权限仅针对你获取的树URI有效，一旦用户在系统设置中撤销了应用对该目录的权限，所有基于此树的子URI访问都会失效。
• DocumentFile的必要性：直接使用DocumentFile遍历子目录获取文件URI是更可靠的方式，它会自动处理URI的格式和权限验证，减少手动拼接带来的错误。

优化实现示例 #

以下是通过DocumentFile安全访问子文件的Kotlin代码示例：

// 已获取的树URI
val treeUri = Uri.parse("content://com.android.externalstorage.documents/tree/1234-5678:Android/media/Music")
val rootDocument = DocumentFile.fromTreeUri(requireContext(), treeUri)

// 逐级获取子文件
rootDocument?.findFile("Artist")?.findFile("Album")?.findFile("song.flac")?.let { songFile ->
    requireContext().contentResolver.openFileDescriptor(songFile.uri, "r")?.use { fileDescriptor ->
        // 在这里处理文件描述符，比如读取文件内容
        val inputStream = FileInputStream(fileDescriptor.fileDescriptor)
        // ... 后续操作
    }
}

常见错误排查 #

如果调用openFileDescriptor时抛出SecurityException，优先检查：

1. 子URI是否是从已授权的树URI正确衍生的，而非手动拼接错误。
2. 是否申请了对应的访问权限（读/写）。
3. 用户是否未在系统设置中撤销该目录的访问权限。

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