为何照片编辑器无法接收系统照片选择器返回的URI？

问题描述 #

使用系统照片选择器（通过PickVisualMedia）获取照片后，调用com.android.camera.action.CROP Intent进行裁剪时，Google Photos提示“错误，无法加载媒体”并退出，其他照片编辑器也出现类似警告或崩溃。尝试takePersistableUriPermission后问题依旧。

核心原因 #

系统照片选择器返回的是临时权限的Content URI，第三方裁剪应用没有访问该URI的权限。takePersistableUriPermission仅对来自DocumentsProvider的URI生效，照片选择器的URI不支持该权限，因此无法解决问题。此外，com.android.camera.action.CROP并非Android标准Intent，不同应用的实现逻辑差异较大，权限传递是核心痛点。

解决方案：通过FileProvider共享本地文件 #

将选中的图片复制到应用私有缓存目录，再通过FileProvider生成可共享的URI传递给裁剪应用，确保对方拥有访问权限。

步骤1：配置FileProvider #

在AndroidManifest.xml中注册FileProvider：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

在res/xml目录下创建file_paths.xml，指定共享的文件路径：

<?xml version="1.0" encoding="utf-8"?>
<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 共享应用缓存目录下的images文件夹 -->
    <cache-path name="cached_images" path="images/" />
</paths>

步骤2：复制选中的图片到缓存目录 #

添加工具函数，将照片选择器返回的URI对应的文件复制到应用缓存目录：

private fun copyUriToCache(uri: Uri): File? {
    return try {
        val inputStream = requireContext().contentResolver.openInputStream(uri) ?: return null
        val cacheDir = File(requireContext().cacheDir, "images")
        // 创建缓存目录（不存在则创建）
        cacheDir.mkdirs()
        // 生成临时文件名
        val tempFile = File(cacheDir, "temp_crop_${System.currentTimeMillis()}.jpg")
        val outputStream = FileOutputStream(tempFile)
        // 复制文件流
        inputStream.copyTo(outputStream)
        // 关闭流
        inputStream.close()
        outputStream.close()
        tempFile
    } catch (e: IOException) {
        e.printStackTrace()
        null
    }
}

步骤3：修改裁剪Intent调用逻辑 #

在pickerCallback中替换原有代码，使用FileProvider生成的URI启动裁剪：

val tempFile = copyUriToCache(uri) ?: return
// 通过FileProvider生成可共享的URI
val cropUri = FileProvider.getUriForFile(
    requireContext(),
    "${requireContext().packageName}.fileprovider",
    tempFile
)

val cropIntent = Intent("com.android.camera.action.CROP")
// 设置数据类型为图片
cropIntent.setDataAndType(cropUri, "image/*")
// 授予裁剪应用临时读取权限
cropIntent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
// 裁剪参数配置
cropIntent.putExtra("crop", "true")
cropIntent.putExtra("aspectX", 1)
cropIntent.putExtra("aspectY", 1)
cropIntent.putExtra("outputX", 500)
cropIntent.putExtra("outputY", 500)

// 建议：避免使用return-data=true（易引发OOM），改为指定输出文件
cropIntent.putExtra("return-data", false)
// 指定裁剪后的输出URI（可复用临时文件或新建文件）
cropIntent.putExtra(MediaStore.EXTRA_OUTPUT, cropUri)

cropResultLauncher!!.launch(cropIntent)

额外提示 #

1. 清理临时文件：裁剪完成或取消后，记得删除缓存目录下的临时文件，避免占用存储空间。
2. 替换return-data=true：该参数会直接返回Bitmap，对于大尺寸图片极易引发内存溢出，使用EXTRA_OUTPUT指定输出文件是更稳定的方案。

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