API 33下无法删除外部存储路径文件的技术咨询

问题原因 #

Android 13（API 33）重构了外部存储权限模型，废弃了WRITE_EXTERNAL_STORAGE权限，同时限制了File类对公共媒体目录（如Pictures）文件的直接删除操作。即使文件存在，直接调用file.delete()也会因权限或系统限制失效，而API 31及之前版本的权限模型允许这种操作。

解决方案 #

改用MediaStore API来删除公共媒体文件，这是API 33及以上版本推荐的操作方式：

1. 申请必要权限

在AndroidManifest.xml中添加权限：

<!-- API 33+ 读取图片文件所需权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<!-- 若需删除其他应用创建的文件，需申请MANAGE_MEDIA权限（需引导用户到设置页手动开启） -->
<uses-permission android:name="android.permission.MANAGE_MEDIA" />

2. 使用MediaStore删除文件

通过文件路径匹配MediaStore中的记录并执行删除：

public boolean deleteImageFromMediaStore(Context context, String filePath) {
    ContentResolver resolver = context.getContentResolver();
    Uri contentUri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;

    // 根据文件路径构建查询条件
    String selection = MediaStore.Images.Media.DATA + "=?";
    String[] selectionArgs = new String[]{filePath};

    // 执行删除并返回结果
    int deletedRows = resolver.delete(contentUri, selection, selectionArgs);
    return deletedRows > 0;
}

替换原代码中的删除逻辑：

String filePath = Environment.getExternalStorageDirectory().toString() + "/Pictures/IMG_20230211_060830.jpg";
File file = new File(filePath);
if (file.exists()) {
    boolean isDeleted = deleteImageFromMediaStore(this, filePath);
    // 可通过isDeleted判断删除是否成功
}

3. 自有文件的简化处理

如果该文件是你的应用创建的，建议将其存储在应用专属外部目录（如getExternalFilesDir(Environment.DIRECTORY_PICTURES)），而非公共Pictures目录。这种情况下直接调用file.delete()即可，API 33也能正常执行，无需额外权限。

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