Jetpack Compose中通过ContentResolver操作MediaStore.Images是否正确？

我开发了一个简易Jetpack Compose应用，支持拍照或从相册选取图片并上传至服务器，不确定当前实现是否正确。

目标版本：Android 8+，已获取READ_EXTERNAL_STORAGE、READ_MEDIA_IMAGES权限

核心疑问 #

1. 拍照获取的URI格式为content://media/external/images/media/...，从相册选取的URI格式为content://com.android.providers.media.documents/document/...，我写了两个基于ContentResolver查询MediaStore.Images的方法来获取文件路径，不确定是否需要分开写两个方法。
2. AsyncImage(model = uri, contentDescription = "image")可以正常加载两种格式的URI。
3. 是否可以直接使用URI通过Retrofit发送文件，不用转换成File？

我的实现代码 #

启动器定义 #

val cameraLauncher = rememberLauncherForActivityResult(
        contract = ActivityResultContracts.TakePicture(),
        onResult = { success ->
            viewModel.handlePictureTake(success)
        }
    )
val imagePicker = rememberLauncherForActivityResult(
        contract = ActivityResultContracts.GetContent(),
        onResult = { uri ->
            if (uri != null) {
                viewModel.onAttachmentEvent(AttachmentEvent.AddAttachment(uri.toString()))
            }
        }
    )

拍照功能实现 #

fun getImageUri(context: Context): Uri? {
            val timestamp: String = SimpleDateFormat("yyyyMMdd_HHmmss", Locale.getDefault()).format(Date())

            val resolver = context.contentResolver
            val contentValues = ContentValues().apply {
                put(MediaStore.MediaColumns.DISPLAY_NAME, "image_$timestamp")
                put(MediaStore.MediaColumns.MIME_TYPE, "image/jpeg")
            }

            return resolver.insert(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, contentValues)
        }
val uri = getImageUri(context)
if (uri != null) {
   cameraLauncher.launch(uri)
}

生成的URI格式：content://media/external/images/media/....

相册选取调用 #

imagePicker.launch("image/*")

获取到的URI格式：content://com.android.providers.media.documents/document/....

URI转文件路径方法 #

// Get file path for In-App created files by URI: (content://media/external/images/media/....)
fun getFilePathFromUri(context: Context, uri: Uri): String? {
    var filePath: String? = null
    val projection = arrayOf(MediaStore.Images.Media.DATA, MediaStore.Images.Media._ID)
    val cursor = context.contentResolver.query(uri, projection, null, null, null)
    if (cursor != null) {
        if (cursor.moveToFirst()) {
            val columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
            filePath = cursor.getString(columnIndex)
        }
        cursor.close()
    }
    return filePath ?: getDocumentPath(context, uri)
}

// Get file path for other App created files by URI: (content://com.android.providers.media.documents/document/....)
private fun getDocumentPath(context: Context, uri: Uri): String? {
    return try {
        var filePath = ""
        val fileId: String = DocumentsContract.getDocumentId(uri)
        val id = fileId.split(":".toRegex())[1]
        val column = arrayOf(MediaStore.Images.Media.DATA)
        val selector = MediaStore.Images.Media._ID + "=?"
        val cursor: Cursor? = context.contentResolver.query(
            MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
            column, selector, arrayOf(id), null
        )
        cursor?.use {
            val columnIndex: Int = cursor.getColumnIndex(column[0])
            if (cursor.moveToFirst()) {
                filePath = cursor.getString(columnIndex)
            }
        }
        return filePath
    } catch (e: SecurityException) {
        null
    }
}

解答 #

关于URI转路径的方法是否需要分开 #

不需要分开写两个方法，可以合并成一个通用方法处理所有类型的content URI。判断URI是否是DocumentsContract类型，再决定查询逻辑：

fun getFilePathFromUri(context: Context, uri: Uri): String? {
    // 处理DocumentsProvider类型的URI
    if (DocumentsContract.isDocumentUri(context, uri)) {
        return try {
            val fileId = DocumentsContract.getDocumentId(uri)
            val id = fileId.split(":".toRegex())[1]
            val projection = arrayOf(MediaStore.Images.Media.DATA)
            val selector = "${MediaStore.Images.Media._ID} = ?"
            context.contentResolver.query(
                MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                projection,
                selector,
                arrayOf(id),
                null
            )?.use { cursor ->
                if (cursor.moveToFirst()) {
                    val columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
                    return cursor.getString(columnIndex)
                }
            }
            null
        } catch (e: SecurityException) {
            null
        }
    } else {
        // 处理直接的MediaStore URI
        val projection = arrayOf(MediaStore.Images.Media.DATA)
        context.contentResolver.query(uri, projection, null, null, null)?.use { cursor ->
            if (cursor.moveToFirst()) {
                val columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
                return cursor.getString(columnIndex)
            }
        }
        return null
    }
}

另外注意MediaStore.Images.Media.DATA在Android 10及以上版本可能返回空或不可访问的路径，因为Scoped Storage限制，这种方式在高版本可能会失效。

关于AsyncImage加载两种URI #

AsyncImage（Coil库）本身支持直接加载content URI，只要应用有对应的访问权限，这个实现是没问题的，不需要额外处理。

关于Retrofit直接使用URI上传 #

完全可以直接使用URI上传，不需要转换成File。Retrofit支持通过RequestBody或MultipartBody.Part结合ContentResolver来创建请求体，示例如下：

首先，创建文件请求体的方法：

fun createRequestBodyFromUri(context: Context, uri: Uri): RequestBody? {
    return context.contentResolver.openInputStream(uri)?.use { inputStream ->
        val mediaType = context.contentResolver.getType(uri)?.toMediaTypeOrNull()
        RequestBody.create(mediaType, inputStream.readBytes())
    }
}

然后在Retrofit接口中定义上传方法：

interface UploadService {
    @Multipart
    @POST("upload")
    suspend fun uploadImage(
        @Part image: MultipartBody.Part
    ): Response<UploadResponse>
}

调用上传时：

val requestBody = createRequestBodyFromUri(context, uri)
requestBody?.let {
    val part = MultipartBody.Part.createFormData(
        "image",
        "filename.jpg",
        it
    )
    uploadService.uploadImage(part)
}

这种方式更符合Android的文件访问规范，尤其是在Scoped Storage环境下，不需要获取真实的文件路径，避免权限问题和路径失效的情况。

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