Android Kotlin：第三方应用保存PDF后权限异常求助

安全阿岳

2026-6-19

问题原因及解决方案

核心原因：Android 10+ 分区存储（Scoped Storage）限制

从Android 10（API 29）开始，系统默认启用分区存储，彻底改变了App访问外部存储的规则，这是你遇到权限问题的根本原因：

公共目录访问限制：你使用的Environment.getExternalStoragePublicDirectory()指向的公共Documents目录属于共享存储区域。在分区存储规则下，你的App仅能直接访问自己创建且未被其他App修改过的文件。当第三方App打开并修改保存该PDF后，文件的访问权限会被重新分配，你的App将失去直接访问的权限。
READ_EXTERNAL_STORAGE权限失效：从Android 11（API 30）起，这个权限仅能让你访问媒体文件（图片、音频、视频），对PDF这类文档文件完全无效。即使在Manifest中声明了该权限，也无法获得公共目录中文档的访问权限。
File API的局限性：分区存储下，File类对共享目录的操作被大幅限制。exists()返回true仅能确认目录存在，但listFiles()返回null是因为你的App没有遍历该目录的权限——系统不允许直接枚举公共目录下的文件内容。

可行解决方案

1. 改用存储访问框架（SAF）获取持久化权限（官方推荐）

这是适合跨App共享文件的标准方案：

打开PDF时，通过ACTION_OPEN_DOCUMENT Intent让用户选择文件，并请求持久化权限：

val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
    addCategory(Intent.CATEGORY_OPENABLE)
    type = "application/pdf"
}
startActivityForResult(intent, REQUEST_CODE_OPEN_DOC)

在onActivityResult中获取文件URI，并获取持久化访问权限：

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_OPEN_DOC && resultCode == Activity.RESULT_OK) {
        data?.data?.let { uri ->
            contentResolver.takePersistableUriPermission(
                uri,
                Intent.FLAG_GRANT_READ_URI_PERMISSION or Intent.FLAG_GRANT_WRITE_URI_PERMISSION
            )
            // 后续通过该URI操作文件，第三方App修改后依然有效
        }
    }
}

之后访问文件时，直接用ContentResolver通过URI操作，不再依赖File类。

2. 切换到App专属外部存储

如果无需其他App长期访问该PDF，可以将文件保存到App专属的外部存储目录：

val appDocsDir = getExternalFilesDir(Environment.DIRECTORY_DOCUMENTS)?.let {
    File(it, "Folder Name")
}

这个目录属于App私有空间，无需任何权限，且你的App始终拥有完全读写权限。若要让第三方App打开编辑，需通过FileProvider共享文件。

3. 申请MANAGE_EXTERNAL_STORAGE权限（不推荐）

如果你的App是文件管理器类应用，确实需要完全访问所有文件，可以申请这个特殊权限：

在Manifest中添加权限：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />

引导用户到设置页面开启权限：

if (!Environment.isExternalStorageManager()) {
    val intent = Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION).apply {
        data = Uri.parse("package:$packageName")
    }
    startActivity(intent)
}

注意：此权限属于高风险权限，Google Play会严格审核，非必要不建议使用。

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