Scoped Storage读写非应用创建文件时的权限错误排查与解决

Scoped Storage的核心规则是：应用仅能直接读写自身创建的文件，或是通过系统文件选择器（Storage Access Framework，SAF）明确授予权限的外部文件。你通过adb push放入Downloads的文件不属于你的应用创建，因此系统会拒绝直接通过文件路径发起的读写请求——哪怕是公共目录也不例外。

针对你恢复备份文件的需求，提供两种可行方案：

方案1：使用SAF让用户手动选择文件（推荐，符合Scoped Storage规范） #

通过系统文件选择器让用户指定备份文件，应用就能获得该文件的读写权限，代码示例如下：

// 定义请求码
private const val REQUEST_CODE_PICK_BACKUP = 1001

// 启动文件选择器
fun pickBackupFile() {
    val intent = Intent(Intent.ACTION_OPEN_DOCUMENT).apply {
        addCategory(Intent.CATEGORY_OPENABLE)
        type = "text/plain" // 根据你的备份文件类型调整，比如application/json
    }
    startActivityForResult(intent, REQUEST_CODE_PICK_BACKUP)
}

// 处理选择结果
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == REQUEST_CODE_PICK_BACKUP && resultCode == RESULT_OK) {
        data?.data?.let { uri ->
            // 读取文件内容
            contentResolver.openInputStream(uri)?.use { inputStream ->
                val backupBytes = inputStream.readBytes()
                // 处理备份数据逻辑
            }
            // 如需写入该文件，使用contentResolver.openOutputStream(uri)
        }
    }
}

如果使用Jetpack组件，建议改用registerForActivityResult替代startActivityForResult。

方案2：Android 10临时兼容（仅过渡用，不推荐长期使用） #

如果你的应用仅需兼容Android 10（API 29），可以在AndroidManifest.xml中添加以下属性，暂时回退到旧的文件权限模型，这样就能直接读写公共目录下的所有文件：

<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

注意：该属性在Android 11（API 30）及以上版本会被系统忽略，强制启用Scoped Storage，因此这只是临时过渡方案。

• 你当前使用的Environment.getExternalStoragePublicDirectory在Android Q及以上已被标记为废弃，建议改用应用私有外部目录（context.getExternalFilesDir(Environment.DIRECTORY_DOWNLOADS)）存放应用自身的文件——这个目录下的文件应用可直接读写，无需权限，且卸载应用时会被自动删除，符合用户预期。
• 若备份场景频繁，建议将备份文件存放在应用私有外部目录，从根源上避免Scoped Storage的权限限制。

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