Android Jetpack Compose：如何将相册图片URI转为File并上传至服务器？

我能通过Coil的AsyncImage展示从Android相册选择的图片URI，代码如下：

@AndroidEntryPoint
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContent {
            var selectedImageUri by remember { mutableStateOf<Uri?>(null) }

            val singlePhotoPikerLauncher = rememberLauncherForActivityResult(
                contract = ActivityResultContracts.PickVisualMedia(),
                onResult = { uri -> selectedImageUri = uri }
            )

            RandomAnimalClientTheme {
                Column(
                    modifier = Modifier
                        .fillMaxSize()
                        .padding(32.dp)
                ) {
                    Spacer(modifier = Modifier.height(8.dp))

                    Button(onClick = {
                        singlePhotoPikerLauncher.launch(
                            PickVisualMediaRequest(ActivityResultContracts.PickVisualMedia.ImageOnly)
                        )
                        Log.d("URI", selectedImageUri.toString())
                    }) {
                        Text(text = "Create new animal")
                    }

                    AsyncImage(model = selectedImageUri, contentDescription = null)
                }
            }
        }
    }
}

也能通过应用assets目录下的图片文件发送Multipart请求，代码如下：

val viewModel: MainViewModel = hiltViewModel()

Button(onClick = {
         if(selectedImageUri!=null){
             val file = File(cacheDir, "myImage.jpg")
             file.createNewFile()
             file.outputStream().use{ assets.open("cat.jpg").copyTo(it) }
             viewModel.sendNewAnimal(
                   animalName = "cat",
                   animalDesc = "a cute mammal",
                   animalImage = file
                   )
             }
       }
) {
        Text(text="send new animal")
}

但问题在于，无法发送相册等应用外部的图片——只能获取到图片的URI，尝试用val file = File(selectedImageUri.path)或val file = selectedImageUri.toFile()转换为File对象时均报错，该如何解决？

问题原因 #

从相册获取的URI通常是content://开头的内容URI，并非真实的文件系统路径，直接通过Uri.path或toFile()无法定位到实际文件，因此会报错。

解决方法 #

方法一：将URI内容复制到应用私有缓存的临时File中 #

通过ContentResolver读取URI对应的输入流，将内容复制到应用缓存目录下的临时文件，再用这个临时文件发送请求：

// 在Composable的Button点击事件中
if (selectedImageUri != null) {
    val context = LocalContext.current
    // 在应用缓存目录创建临时文件
    val tempFile = File(context.cacheDir, "temp_selected_image.jpg")
    tempFile.createNewFile()

    // 读取URI内容并写入临时文件
    context.contentResolver.openInputStream(selectedImageUri!!)?.use { inputStream ->
        tempFile.outputStream().use { outputStream ->
            inputStream.copyTo(outputStream)
        }
    }

    // 调用ViewModel方法发送请求
    viewModel.sendNewAnimal(
        animalName = "cat",
        animalDesc = "a cute mammal",
        animalImage = tempFile
    )
}

注意：请求完成后建议删除临时文件，避免占用缓存空间。

方法二：直接用URI生成RequestBody（推荐，无需创建临时文件） #

如果使用Retrofit发送请求，可以直接通过ContentResolver将URI转换为RequestBody，无需中转File，更高效：

1. 修改ViewModel的sendNewAnimal方法，接收Uri参数：

// ViewModel中的实现
fun sendNewAnimal(animalName: String, animalDesc: String, animalImageUri: Uri) {
    val context = getApplication<Application>().applicationContext
    // 从URI生成图片RequestBody
    val imageRequestBody = context.contentResolver.openInputStream(animalImageUri)?.use { inputStream ->
        RequestBody.create(MediaType.parse("image/jpeg"), inputStream.readBytes())
    } ?: return

    // 构建Multipart请求的图片Part
    val imagePart = MultipartBody.Part.createFormData(
        name = "animalImage", // 对应后端接口的参数名
        filename = "selected_image.jpg",
        body = imageRequestBody
    )

    // 发送请求
    viewModelScope.launch {
        apiService.uploadAnimal(
            name = animalName,
            desc = animalDesc,
            image = imagePart
        )
    }
}

2. 在Composable中直接传入URI：

Button(onClick = {
    selectedImageUri?.let { uri ->
        viewModel.sendNewAnimal(
            animalName = "cat",
            animalDesc = "a cute mammal",
            animalImageUri = uri
        )
    }
}) {
    Text(text = "send new animal")
}

权限说明 #

确保你的应用已申请对应权限：

• Android 13及以上：READ_MEDIA_IMAGES权限
• Android 12及以下：READ_EXTERNAL_STORAGE权限

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