Android Q及以上通过路径删除内部存储图片失败如何解决

问题原因 #

Android 10（API 29）开始引入分区存储机制，应用不再拥有公共存储目录的直接读写权限，你保存在Pictures公共目录下的图片属于媒体库文件，直接通过File路径调用delete方法没有操作权限，所以会出现file.exists()返回true但删除失败的情况。

适配方案 #

按照系统版本分逻辑处理删除操作：

• Android 9及更低版本（API < 29）：可沿用原有File.delete的逻辑，确保已申请WRITE_EXTERNAL_STORAGE权限即可正常删除。
• Android 10及更高版本（API >= 29）：需要通过ContentResolver操作MediaStore来删除媒体文件，不能直接使用File路径操作。

完整适配代码 #

private fun deleteImage(imagePath: String): Boolean {
    return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        deleteImageForQAndAbove(imagePath)
    } else {
        val file = File(imagePath)
        file.exists() && file.delete()
    }
}

@RequiresApi(Build.VERSION_CODES.Q)
private fun deleteImageForQAndAbove(imagePath: String): Boolean {
    val contentResolver = context.contentResolver
    // 通过文件路径查询对应图片在MediaStore中的ID
    val selection = MediaStore.Images.Media.DATA + "=?"
    val selectionArgs = arrayOf(imagePath)
    val cursor = contentResolver.query(
        MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
        arrayOf(MediaStore.Images.Media._ID),
        selection,
        selectionArgs,
        null
    )
    return cursor?.use { 
        if (it.moveToFirst()) {
            val id = it.getLong(it.getColumnIndexOrThrow(MediaStore.Images.Media._ID))
            val imageUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, id)
            // 通过URI删除图片
            contentResolver.delete(imageUri, null, null) > 0
        } else {
            false
        }
    } ?: false
}

优化建议 #

你在Android 10及以上版本保存图片时，generateUri()方法会直接返回图片对应的MediaStore URI，建议保存图片时同时存储该URI，删除时直接传入URI操作，不需要再通过路径查询MediaStore，可提升删除效率，也避免路径匹配失败的问题。

注意事项 #

• 若临时需要兼容旧逻辑，可在AndroidManifest.xml的application节点添加android:requestLegacyExternalStorage="true"，可在Android 10设备上停用分区存储，沿用旧的文件操作逻辑，但该配置在Android 11及以上版本无效，不建议长期使用。
• 删除操作前确保已申请对应存储权限：Android 12及更低版本需要READ_EXTERNAL_STORAGE权限，Android 13及以上版本需要READ_MEDIA_IMAGES权限。

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