Android API33+使用SAF读取所选目录文件遇权限问题求助

问题原因 #

你遇到的权限拒绝是因为：通过ACTION_OPEN_DOCUMENT_TREE获取的Uri权限，仅对选中的根目录Uri生效。直接用DocumentsContract.buildDocumentUri生成的文件Uri，没有继承目录的访问权限，所以会被系统拦截。

正确的文件Uri构建方式 #

要访问目录下的子文件，必须基于根目录的tree Uri来构建文件的Uri，而不是直接用authority和docId生成独立的document Uri。正确的做法是使用DocumentsContract.buildDocumentUriUsingTree方法：

// 替换原来的buildDocumentUri写法
val documentUri = DocumentsContract.buildDocumentUriUsingTree(
    rootUri, // 用户选择的目录根Uri
    fileList.docId // 从cursor获取的子文件docId
)
val contentResolver = requireContext().contentResolver
val inputStream = contentResolver.openInputStream(documentUri)

这个方法会保留根目录Uri的权限上下文，系统会认可你对该子文件的访问权限，这样就能正常打开文件输入流。

权限持久化注意事项 #

如果需要在应用重启后依然保留该目录的访问权限，需要手动将Uri权限加入持久化：

// 在获取到rootUri后调用
requireContext().contentResolver.takePersistableUriPermission(
    rootUri,
    Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
)

这样即使应用重启，也无需重新让用户选择目录，就能继续访问该目录下的所有文件。

替代方案（谨慎使用） #

如果你需要访问更广泛的存储区域，可以考虑申请MANAGE_EXTERNAL_STORAGE权限，但这个权限需要用户跳转到系统设置手动开启，且Google Play对该权限的审核非常严格，仅允许文件管理器类应用使用。代码示例：

// 检查权限
if (!Environment.isExternalStorageManager()) {
    val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION)
    intent.data = Uri.parse("package:${requireContext().packageName}")
    startActivity(intent)
}

但优先推荐使用SAF的正确Uri构建方式，这是符合Android存储最佳实践的方案。

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