Android/Kotlin中ACTION_OPEN_DOCUMENT权限错误解决求助

1. 将图片URI存入数据库再读取是否为最佳实践？ #

直接存储ACTION_OPEN_DOCUMENT获取的URI并非最佳实践，原因有二：

• 权限时效性：这类URI的访问权限默认是临时的，APP重启后会丢失，除非主动持久化权限；
• 依赖原文件：如果用户删除了原图片（比如在相册里删掉），存储的URI就完全失效了。

更稳妥的方案是：选中图片后，将图片复制到APP的私有存储目录（如getFilesDir()或getExternalFilesDir(Environment.DIRECTORY_PICTURES)），然后把私有目录的文件路径存入数据库。这种方式不需要依赖外部权限，也不用担心原文件被删除，完全可控。

当然，如果你的场景只是临时访问图片，或者能接受原文件被删除的风险，存储URI并配合权限持久化也是可行的，但不是最优解。

2. 能否将图片URI存入共享存储？ #

首先明确：共享存储是用于存放文件的空间，并非存储URI的容器。你可能想问的是「能否把图片文件放到共享存储，再存储对应的路径/URI到数据库」——答案是可以，但不推荐：

• Android 10（API 29）及以上，需通过MediaStore API将图片插入到共享存储的公共目录（比如Pictures），无需WRITE_EXTERNAL_STORAGE权限；Android 9及以下则需要申请该权限；
• 共享存储的文件可被其他APP访问，也容易被用户误删，会导致你的APP加载图片失败；
• 若只是为了备份数据，更推荐使用APP私有存储+Android系统的自动备份功能（无需额外权限），而非共享存储。

直接存储ACTION_OPEN_DOCUMENT的URI到共享存储没有实际意义，因为URI只是访问资源的标识，不是文件本身。

3. 如何处理ACTION_OPEN_DOCUMENT的访问限制以解决SecurityException？ #

报错的核心原因是：ACTION_OPEN_DOCUMENT获取的URI默认仅在当前会话拥有访问权限，APP重启或跨进程访问时权限会失效。有两种解决方法：

方法一：持久化URI访问权限 #

在拿到URI后，调用ContentResolver.takePersistableUriPermission()将权限持久化，这样APP重启后依然能访问该URI：

• 先在Manifest的Activity标签中添加android:grantUriPermissions="true"（部分场景默认已开启，但显式添加更稳妥）；
• Kotlin代码示例（使用Activity Result API）：

  val pickImageLauncher = registerForActivityResult(ActivityResultContracts.OpenDocument()) { uri ->
      uri?.let {
          // 申请持久化读取权限
          val takeFlags = Intent.FLAG_GRANT_READ_URI_PERMISSION
          contentResolver.takePersistableUriPermission(it, takeFlags)
          // 将URI存入Room数据库
          viewModel.savePetImageUri(it.toString())
      }
  }
  

  注意：该权限与APP绑定，用户卸载APP后权限自动失效，且仅对ACTION_OPEN_DOCUMENT/ACTION_GET_CONTENT获取的URI有效。

方法二：复制图片到私有存储 #

彻底规避权限问题的方案：拿到URI后，将图片流复制到APP私有目录，存储私有路径到数据库：

uri?.let { docUri ->
    contentResolver.openInputStream(docUri)?.use { inputStream ->
        // 创建私有目录下的文件
        val fileName = "pet_${System.currentTimeMillis()}.png"
        val targetFile = File(filesDir, fileName)
        // 复制文件流
        FileOutputStream(targetFile).use { outputStream ->
            inputStream.copyTo(outputStream)
        }
        // 存储私有文件路径到数据库
        viewModel.savePetImagePath(targetFile.absolutePath)
    }
}

后续加载图片时，直接通过私有路径读取，无需任何外部权限，完全避免权限异常。

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