Android 13下MediaStore文件删除及外部存储写入异常排查

解答 #

1. 问题产生原因 #

Android 13对外部存储权限模型做了核心调整，结合你的现象，原因可归纳为两点：

• MediaStore元数据与实际文件系统不同步：目标路径属于Documents目录下的自定义文件夹，MediaStore的缓存条目未同步实际文件删除操作，导致系统判定文件仍存在
• 直接文件操作权限限制：Android 13收紧了直接访问外部存储路径的权限，传统C/C++方式创建文件时，可能因MediaStore的虚拟文件映射冲突或权限不足导致失败

2. 是否由MediaStore导致？ #

是的，你的所有症状都指向MediaStore元数据残留：

• 实际文件夹为空，但TFile::Copy提示文件已存在——TFile底层大概率调用了MediaStore的查询接口，而非直接读取文件系统状态
• C/C++创建文件失败，是因为MediaStore已标记该路径存在，内核层拦截了文件创建请求
• 卸载重装后问题依旧，因为MediaStore是系统级数据库，不会随单个应用卸载自动清理无关元数据条目

3. 现有mediastore_cleanup()是否有效？不指定RELATIVE_PATH能否找到条目？ #

现有函数大概率无效，原因如下：

• 仅通过DISPLAY_NAME查询会匹配所有目录下的同名文件，无法精准定位到Documents/myapp下的目标条目
• 若未指定正确的MediaStore集合（需使用MediaStore.Files而非媒体专属集合），也会导致查询不到目标元数据
• 返回0说明没有匹配到可删除的条目，进一步证明查询条件不精准

不指定RELATIVE_PATH几乎无法精准找到目标条目，因为系统中可能存在多个同名文件。

4. 同时指定RELATIVE_PATH和DISPLAY_NAME的删除查询写法 #

针对Documents/myapp/abcdef1234.dat，需精准查询MediaStore.Files集合，示例代码（Java）如下：

// 获取外部存储Files集合的URI
Uri filesUri = MediaStore.Files.getContentUri("external");

// 构建查询条件：匹配文件名和相对路径
String selection = MediaStore.Files.FileColumns.DISPLAY_NAME + " = ? AND " +
                   MediaStore.Files.FileColumns.RELATIVE_PATH + " = ?";
// RELATIVE_PATH需以/结尾，确保匹配正确的目录
String[] selectionArgs = new String[]{"abcdef1234.dat", "Documents/myapp/"};

// 执行删除操作
int deletedRows = getContentResolver().delete(filesUri, selection, selectionArgs);

关键注意点：

• 必须使用MediaStore.Files集合，不能用Images/Videos等媒体专属集合，因为目标文件是普通文档
• RELATIVE_PATH的值必须以/结尾，否则可能匹配失败

5. 是否需要在Manifest中添加权限？ #

需要，需根据Android版本适配：

• Android 13及以上：
  • 若通过MediaStore操作，无需MANAGE_EXTERNAL_STORAGE，但需确保已申请READ_MEDIA_*权限（如果操作媒体文件）；针对普通文档，仅需基础的READ_EXTERNAL_STORAGE（Android 13中已被READ_MEDIA_*替代，若兼容旧版本可保留）
  • 若使用C/C++直接操作文件路径，需申请MANAGE_EXTERNAL_STORAGE特殊权限，且需引导用户到系统设置页面开启
• 更优方案：使用ACTION_OPEN_DOCUMENT_TREE让用户主动授权访问Documents/myapp目录，这种方式符合Android 13的权限规范，无需依赖特殊权限

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