Android中使用PhotoPicker删除外部存储图片遇Volume picker错误

核心原因 #

PhotoPicker返回的Uri是媒体内容提供器的临时访问Uri，仅授予读取权限，不支持直接删除操作；且这类Uri并非指向真实文件路径，系统无法识别对应的存储卷，因此抛出"Volume picker not found"异常。

修正步骤 #

1. 通过MediaStore API删除媒体条目 #

替换原有的直接删除Uri逻辑，改为查询媒体库获取对应ID后删除：

// 替换原有的context.contentResolver.delete(uri, null, null)代码块
val projection = arrayOf(MediaStore.Images.Media._ID)
val cursor = context.contentResolver.query(uri, projection, null, null, null)
cursor?.use {
    if (it.moveToFirst()) {
        val mediaId = it.getLong(it.getColumnIndexOrThrow(MediaStore.Images.Media._ID))
        // 构建删除条件
        val deleteUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI
        val whereClause = "${MediaStore.Images.Media._ID} = ?"
        val whereArgs = arrayOf(mediaId.toString())
        // 执行删除
        val deletedRows = context.contentResolver.delete(deleteUri, whereClause, whereArgs)
        Log.d("Delete", "Deleted $deletedRows rows")
    }
}

如果处理视频，将MediaStore.Images.Media替换为MediaStore.Video.Media即可。

2. 权限检查 #

• Android 12及以下：确保已申请WRITE_EXTERNAL_STORAGE权限
• Android 13及以上：申请READ_MEDIA_IMAGES（图片）/READ_MEDIA_VIDEO（视频）权限
• 注意：Android 10+即使拥有存储权限，也必须通过MediaStore API删除媒体文件，不能直接操作文件路径。

3. 优化文件名冲突处理 #

原代码中若内部存储已有同名文件会直接覆盖，建议添加冲突处理：

// 生成不重复的文件名
fun getUniqueFileName(context: Context, originalName: String): String {
    val fileExtension = originalName.substringAfterLast(".", "")
    val fileNameWithoutExt = originalName.substringBeforeLast(".")
    var counter = 1
    var newName = originalName
    while (File(context.filesDir, newName).exists()) {
        newName = "$fileNameWithoutExt($counter).$fileExtension"
        counter++
    }
    return newName
}

// 使用方式
val displayName = cursor?.use {
    if (it.moveToFirst()) getUniqueFileName(context, it.getString(it.getColumnIndexOrThrow(OpenableColumns.DISPLAY_NAME)))
    else "file_${System.currentTimeMillis()}"
} ?: "file_${System.currentTimeMillis()}"

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