Android手机图库图片删除问题求助：已尝试Stack Overflow方案仍失败

一、权限适配（核心前提） #

不同Android版本的权限要求不同，必须先确保权限申请通过：

• Android 6.0（API23）~ Android9（API28）：需动态申请WRITE_EXTERNAL_STORAGE权限
• Android10（API29）~ Android12（API32）：需动态申请READ_EXTERNAL_STORAGE权限，无需写入权限（通过MediaStore API操作）
• Android13+（API33）：需动态申请READ_MEDIA_IMAGES权限

权限申请示例（用Jetpack Activity Result API）：

private val requestPermissionLauncher = registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->
    if (isGranted) {
        deleteImage(targetImageUri) // 替换为你的目标图片Uri
    } else {
        Toast.makeText(this, "需要权限才能执行删除操作", Toast.LENGTH_SHORT).show()
    }
}

// 触发权限检查与申请
fun startDeleteFlow() {
    val requiredPermission = when {
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU -> Manifest.permission.READ_MEDIA_IMAGES
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.M -> Manifest.permission.READ_EXTERNAL_STORAGE
        else -> ""
    }

    if (requiredPermission.isNotEmpty() && ContextCompat.checkSelfPermission(this, requiredPermission) != PackageManager.PERMISSION_GRANTED) {
        requestPermissionLauncher.launch(requiredPermission)
    } else {
        deleteImage(targetImageUri)
    }
}

二、分版本删除实现 #

1. Android10+（API29及以上） #

直接通过ContentResolver调用MediaStore的删除接口，无需操作文件路径：

fun deleteImage(imageUri: Uri) {
    try {
        val rowsDeleted = contentResolver.delete(imageUri, null, null)
        if (rowsDeleted > 0) {
            Toast.makeText(this, "图片删除成功", Toast.LENGTH_SHORT).show()
            // 部分厂商系统需手动触发图库刷新
            sendBroadcast(Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE, imageUri))
        } else {
            Toast.makeText(this, "图片删除失败", Toast.LENGTH_SHORT).show()
        }
    } catch (e: Exception) {
        e.printStackTrace()
        Toast.makeText(this, "删除出错：${e.message}", Toast.LENGTH_SHORT).show()
    }
}

2. Android9及以下（API28及以下） #

先删除本地文件，再通知MediaScanner刷新图库索引：

fun deleteImage(imageUri: Uri) {
    try {
        val filePath = getFilePathFromUri(imageUri) ?: run {
            Toast.makeText(this, "无法获取图片路径", Toast.LENGTH_SHORT).show()
            return
        }
        val targetFile = File(filePath)
        if (targetFile.exists() && targetFile.delete()) {
            // 通知图库刷新
            MediaScannerConnection.scanFile(
                this,
                arrayOf(filePath),
                null
            ) { _, _ ->
                Toast.makeText(this, "图片删除成功", Toast.LENGTH_SHORT).show()
            }
        } else {
            Toast.makeText(this, "图片删除失败或不存在", Toast.LENGTH_SHORT).show()
        }
    } catch (e: Exception) {
        e.printStackTrace()
        Toast.makeText(this, "删除出错：${e.message}", Toast.LENGTH_SHORT).show()
    }
}

// 从Uri解析文件路径（仅适用于API28及以下）
private fun getFilePathFromUri(uri: Uri): String? {
    contentResolver.query(uri, arrayOf(MediaStore.Images.Media.DATA), null, null, null)?.use { cursor ->
        if (cursor.moveToFirst()) {
            val columnIndex = cursor.getColumnIndexOrThrow(MediaStore.Images.Media.DATA)
            return cursor.getString(columnIndex)
        }
    }
    return null
}

三、兼容方案（规避系统限制） #

部分厂商系统会禁止APP删除非自身创建的图片，此时可调用系统自带的删除界面：

fun deleteViaSystem(imageUri: Uri) {
    val deleteIntent = Intent(Intent.ACTION_DELETE)
    deleteIntent.data = imageUri
    startActivity(deleteIntent)
}

四、常见失败原因排查 #

• 权限未正确申请：检查动态权限是否通过，Android13+务必申请READ_MEDIA_IMAGES而非旧存储权限
• Uri无效：确保使用的是MediaStore提供的合法Uri，而非直接的文件路径Uri（Android10+禁止直接访问文件）
• 系统限制：部分定制ROM限制第三方APP删除系统图库图片，此时优先使用系统删除界面

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