如何获取文件URI永久访问权限？适配Android 11+头像功能

近两日在应用中基于Uri实现头像功能，该功能在Android 11以下版本可正常运行，但在Android 11及以上版本失效。当前代码基于Android官方相机基础教程，核心逻辑是通过Intent选择图库图片或拍摄照片，获取Uri后存入Room数据库，但高版本系统下无法正常工作。

Android 11及以上的存储权限机制发生了关键变更：

• 从图库通过ACTION_OPEN_DOCUMENT获取的Uri仅拥有临时访问权限，应用重启或一段时间后权限会自动失效，直接存储该Uri会导致后续无法访问文件。
• 拍摄照片生成的文件存放在应用外部私有目录，虽然自身应用有权限访问，但如果文件被系统清理或路径发生变更，存储的原始Uri同样会失效。

是的，必须将选中/拍摄的图片复制到应用私有存储目录，再存储该私有文件的路径，以此规避权限和文件失效问题。具体实现步骤如下：

1. 实现文件复制工具函数 #

创建工具函数，将Uri指向的图片文件复制到应用内部私有目录，确保永久可访问：

private fun copyImageToPrivateStorage(sourceUri: Uri): String? {
    return try {
        // 打开源文件输入流
        val inputStream = requireContext().contentResolver.openInputStream(sourceUri)
        // 创建私有存储目录（不存在则创建）
        val privateDir = requireContext().filesDir.resolve("profile_images")
        if (!privateDir.exists()) privateDir.mkdirs()
        
        // 生成唯一文件名
        val fileName = "profile_${System.currentTimeMillis()}.jpg"
        val targetFile = privateDir.resolve(fileName)
        
        // 复制文件
        val outputStream = FileOutputStream(targetFile)
        inputStream?.copyTo(outputStream)
        
        // 关闭流
        inputStream?.close()
        outputStream.close()
        
        targetFile.absolutePath // 返回私有目录下的文件路径，用于存入Room
    } catch (e: IOException) {
        e.printStackTrace()
        null
    }
}

2. 修改Intent结果处理逻辑 #

不再直接存储原始Uri，而是先复制文件到私有目录，再保存路径：

private val intentLauncher = registerForActivityResult(ActivityResultContracts.StartActivityForResult()) {
    if (it.resultCode == Activity.RESULT_OK) {
        val photoResult: Uri? = it.data?.data
        if (photoResult != null) {
            // 处理图库选择的图片
            copyImageToPrivateStorage(photoResult)?.let { filePath ->
                changeProfilePicture(filePath) // 修改changeProfilePicture方法，改为存储文件路径
            }
        } else {
            // 处理拍摄的照片，复制临时拍摄文件到私有目录
            copyImageToPrivateStorage(currentPhotoUri)?.let { filePath ->
                changeProfilePicture(filePath)
            }
        }
    }
}

3. 优化拍摄照片的临时文件逻辑（可选） #

拍摄照片时直接在私有目录创建临时文件，减少一次复制操作（需确保FileProvider配置正确）：

@Throws(IOException::class)
private fun createImageFile(): File {
    val tempDir = requireContext().filesDir.resolve("temp_camera")
    if (!tempDir.exists()) tempDir.mkdirs()
    
    val timeStamp = SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(Date())
    return File.createTempFile(
        "JPEG_${timeStamp}_",
        ".jpg",
        tempDir
    ).apply {
        currentPhotoUri = FileProvider.getUriForFile(
            requireContext(),
            "${requireActivity().packageName}.fileprovider",
            this
        )
    }
}

4. 头像加载逻辑 #

从Room取出文件路径后，直接通过File加载图片：

fun loadProfilePicture(filePath: String) {
    val profileFile = File(filePath)
    if (profileFile.exists()) {
        // 用图片加载库（如Glide）加载私有文件
        Glide.with(this)
            .load(profileFile)
            .into(profileImageView)
    } else {
        // 加载默认头像
    }
}

关键注意点 #

• 应用私有存储（内部filesDir或外部getExternalFilesDir）无需申请额外存储权限，Android 11及以上系统默认允许访问。
• 禁止直接存储原始Uri，无论是图库临时权限Uri还是外部文件Uri，都存在失效风险。

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