Android R 下使用MediaStore向Download目录写入异常(Android Q正常)
Android R 上 MediaStore 写入 Download 目录无显示的问题定位与修复
问题根因
- 从 Android 11(R,API 30)开始,系统对
MediaStore.Downloads集合的条目可见性规则做了收紧:当你通过contentResolver.insert()创建下载条目、再调用openOutputStream()写入内容时,系统会自动把该条目的IS_PENDING字段置为 1,标记文件处于“待完成写入”的临时状态。此时系统的文件管理器、Download 目录的展示逻辑会直接过滤这类条目,用户完全看不到。 - Android 10(Q)没有启用这套自动状态标记逻辑,没设置
IS_PENDING的条目默认状态就是 0,流写完就能正常展示,这就是同样的代码在 Q 正常、在 R 看不到文件的核心差异。
代码中存在的其他适配隐患
- MIME 类型获取逻辑错误:代码里用
contentResolver.getType(Uri.fromFile(downloadedFile))取文件类型,但Uri.fromFile()生成的是裸 File Uri,受 Android 7.0 以上的 FileUriExposure 机制限制,ContentResolver 根本识别不了这类 Uri,通常返回 null。到了 R 版本,系统会直接因为条目没有合法 MIME 类型,不把它纳入 Download 目录的索引。 - 未显式声明存储相对路径:虽然
MediaStore.Downloads.EXTERNAL_CONTENT_URI的默认存储路径是公共 Download 目录,但 R 版本上不少国产定制 ROM 会因为缺少显式的RELATIVE_PATH声明,把新写入的条目归到其他用户不可见的隐藏目录,导致常规路径下找不到文件。 - 提前写入的 SIZE 字段未做实际校验:你在 insert 阶段就把私有目录源文件的长度写入
SIZE字段,如果实际写入时出现缓冲未刷新、内容截断的情况,R 版本的 MediaStore 会因为条目记录的大小和磁盘上实际的文件大小不匹配,直接过滤该条目的展示。
可直接运行的修复代码
调整逻辑后可以对齐 Chrome 的 Download 目录写入行为:
File downloadedFile = new File(getContext().getFilesDir(), FILE_NAME); ContentResolver contentResolver = getContext().getContentResolver(); Uri uri; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) { ContentValues contentValues = new ContentValues(); contentValues.put(MediaStore.MediaColumns.DISPLAY_NAME, downloadedFile.getName()); // 根据文件名后缀判断MIME类型,不要用裸FileUri取类型 String mimeType = getMimeTypeFromFileName(downloadedFile.getName()); contentValues.put(MediaStore.MediaColumns.MIME_TYPE, mimeType); // 显式指定相对路径为公共Download目录 contentValues.put(MediaStore.MediaColumns.RELATIVE_PATH, Environment.DIRECTORY_DOWNLOADS); // 写入前置标记为临时状态,避免写入过程被其他应用读到半成品 contentValues.put(MediaStore.MediaColumns.IS_PENDING, 1); // 不提前写入SIZE,等实际写完后再更新准确值 uri = contentResolver.insert(MediaStore.Downloads.EXTERNAL_CONTENT_URI, contentValues); } else { // 低版本写入逻辑省略 } try ( OutputStream outputStream = contentResolver.openOutputStream(uri, "w"); BufferedInputStream bufferedInputStream = new BufferedInputStream(new FileInputStream(downloadedFile.getAbsoluteFile())) ) { byte[] buff = new byte[1024]; int len; long writtenSize = 0; while ((len = bufferedInputStream.read(buff)) > 0) { outputStream.write(buff, 0, len); writtenSize += len; } // 强制刷新缓冲区,确保所有内容落盘 outputStream.flush(); if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q && uri != null) { // 写入完成后更新状态,让系统把文件展示给用户 ContentValues updateValues = new ContentValues(); updateValues.put(MediaStore.MediaColumns.IS_PENDING, 0); updateValues.put(MediaStore.MediaColumns.SIZE, writtenSize); contentResolver.update(uri, updateValues, null, null); } } catch (IOException e) { // 写入失败时清理之前插入的空条目,避免留下0字节的损坏文件 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q && uri != null) { contentResolver.delete(uri, null, null); } // 异常处理逻辑省略 }
其中 getMimeTypeFromFileName 方法可以借助系统内置的 MimeTypeMap 工具类实现,不需要额外依赖:
private String getMimeTypeFromFileName(String fileName) { String extension = MimeTypeMap.getFileExtensionFromUrl(fileName); return MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension); }
注意:Android R 及以上版本,不需要申请
WRITE_EXTERNAL_STORAGE权限就可以通过 MediaStore 写入公共 Download 目录,不要为了兼容旧逻辑申请过时的存储权限,否则会触发系统的权限拦截,导致写入失败。
内容的提问来源于stack exchange,提问作者V_Martusciello
相关产品推荐
相关产品推荐

