You need to enable JavaScript to run this app. Android R 下使用MediaStore向Download目录写入异常(Android Q正常)
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.06 05:36:03