Android中如何将URI转换为文件？适配Android 7至13版本

你遇到的错误是因为uri.toFile()仅支持file://协议的URI，而PhotoPicker返回的content://开头的是媒体库统一资源标识符，这类URI并不指向直接的文件路径。尤其在Android 7+的权限机制（包括Android 10+的分区存储）下，APP无法直接访问媒体库文件的原始路径，必须通过ContentResolver读取文件内容并复制到可访问的目录生成File。

实现工具方法 #

下面是适配全版本的URI转File工具函数，核心逻辑是将content URI对应的文件内容复制到APP私有存储目录（无需额外权限）：

import android.content.Context
import android.net.Uri
import android.os.Environment
import java.io.File
import java.io.FileOutputStream
import java.io.InputStream
import java.io.OutputStream

fun uriToFile(context: Context, uri: Uri): File? {
    return try {
        // 获取URI对应的输入流
        val inputStream: InputStream? = context.contentResolver.openInputStream(uri)
        inputStream ?: return null

        // 生成目标文件：放在APP外部私有图片目录，卸载APP时会自动删除
        val originalFileName = getFileName(context, uri) ?: "temp_${System.currentTimeMillis()}"
        val fileExtension = originalFileName.substringAfterLast(".", ".jpg") // 默认用jpg后缀
        val targetDir = context.getExternalFilesDir(Environment.DIRECTORY_PICTURES)
        targetDir ?: return null
        val targetFile = File(targetDir, "${originalFileName}_copy$fileExtension")

        // 复制文件流到目标文件
        val outputStream: OutputStream = FileOutputStream(targetFile)
        val buffer = ByteArray(4096)
        var bytesRead: Int
        while (inputStream.read(buffer).also { bytesRead = it } != -1) {
            outputStream.write(buffer, 0, bytesRead)
        }

        // 关闭流资源
        outputStream.flush()
        outputStream.close()
        inputStream.close()

        targetFile
    } catch (e: Exception) {
        e.printStackTrace()
        null
    }
}

// 辅助方法：从content URI获取原文件名
fun getFileName(context: Context, uri: Uri): String? {
    val cursor = context.contentResolver.query(uri, null, null, null, null)
    cursor?.use {
        if (it.moveToFirst()) {
            return it.getString(it.getColumnIndexOrThrow("_display_name"))
        }
    }
    return null
}

关键说明 #

• 存储目录选择：使用getExternalFilesDir()获取APP私有外部存储目录，Android 7+无需申请READ_EXTERNAL_STORAGE或WRITE_EXTERNAL_STORAGE权限，且文件会随APP卸载自动清理，避免垃圾文件残留。
• 文件名处理：通过查询媒体库获取原文件名，保留原后缀，确保文件格式正确；若查询失败则用时间戳生成唯一文件名，避免重复覆盖。
• 异常处理：复制过程中捕获IO异常并打印日志，避免APP崩溃。

整合到现有代码 #

在你的PhotoPicker回调中调用工具方法即可：

val pickMedia = registerForActivityResult(ActivityResultContracts.PickVisualMedia()) { uri ->
    if (uri != null) {
        Log.e("PhotoPicker", "Selected URI: $uri")
        // 转换URI为File
        val file = uriToFile(this@YourActivity, uri)
        file?.let {
            Log.e("PhotoPicker", "Converted File: ${it.absolutePath}")
            // 这里添加你对文件的后续处理逻辑
        } ?: run {
            Log.e("PhotoPicker", "Failed to convert URI to File")
        }
    } else {
        Log.e("PhotoPicker", "No media selected")
    }
}

适配注意事项 #

• Android 13+：PhotoPicker无需申请媒体权限，通过ContentResolver访问URI的权限由系统自动授予，无需额外处理。
• 多类型媒体支持：如果需要处理视频、音频等其他类型文件，只需确保后缀名与原文件一致即可，无需修改核心复制逻辑。

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