You need to enable JavaScript to run this app. 适配Android 10以下MediaStore存储:音频与普通文件写入报错问题
优惠活动
大模型
产品
解决方案
定价
更多

适配Android 10以下MediaStore存储:音频与普通文件写入报错问题

Android 10 以下 MediaStore 适配崩溃解决方案

崩溃根因定位

  • 音频写入触发NullPointerException:Android 10 以下版本的MediaStore.Audio集合没有做路径兜底逻辑,当ContentValues没有传入MediaStore.MediaColumns.DATA对应的实际存储路径时,系统内部解析路径做文件后缀匹配时,会拿到null值调用lastIndexOf方法,直接触发空指针。
  • 非媒体类型文件写入触发IllegalArgumentException: no path was provided:MediaStore.Files集合在Android 10以下版本的插入逻辑,强制要求必须显式传入完整的文件绝对路径,缺失该值时系统直接抛出参数异常。
  • 图片、视频之前存储正常的原因:多数设备ROM对MediaStore.Images、MediaStore.Video的插入逻辑做了路径自动生成的兜底,没有强制校验DATA字段,所以不会触发崩溃,但这属于ROM定制逻辑,不是系统原生行为,不能作为通用适配的依赖。

通用适配实现逻辑

Android 10 以下的MediaStore体系无Scoped Storage权限限制,所有集合的插入操作都必须显式补全文件的完整绝对路径,同时根据文件MIME类型匹配对应的公共存储目录,避免触发系统校验异常。
修改后的完整代码如下:

fun createDownloadsFile(context: Context, fileName: String, mimeType: String): Uri? {
    val values = ContentValues().apply {
        put(MediaStore.MediaColumns.DISPLAY_NAME, fileName)
        put(MediaStore.MediaColumns.MIME_TYPE, mimeType)
    }
    val collection = if (hasAndroid10()) {
        values.put(MediaStore.MediaColumns.IS_PENDING, 1)
        MediaStore.Downloads.getContentUri(MediaStore.VOLUME_EXTERNAL_PRIMARY)
    } else {
        // 按MIME类型匹配对应的公共存储父目录
        val targetParentType = when {
            mimeType.startsWith("image/") -> Environment.DIRECTORY_PICTURES
            mimeType.startsWith("audio/") -> Environment.DIRECTORY_MUSIC
            mimeType.startsWith("video/") -> Environment.DIRECTORY_MOVIES
            else -> Environment.DIRECTORY_DOWNLOADS
        }
        // 获取父目录实例并确保目录存在
        val parentDir = Environment.getExternalStoragePublicDirectory(targetParentType)
        if (!parentDir.exists()) {
            parentDir.mkdirs()
        }
        // 拼接完整文件路径并填入ContentValues的DATA字段
        val fullFilePath = File(parentDir, fileName).absolutePath
        values.put(MediaStore.MediaColumns.DATA, fullFilePath)
        // 返回对应类型的MediaStore集合Uri
        when {
            mimeType.startsWith("image/") -> MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL)
            mimeType.startsWith("audio/") -> MediaStore.Audio.Media.getContentUri(MediaStore.VOLUME_EXTERNAL)
            mimeType.startsWith("video/") -> MediaStore.Video.Media.getContentUri(MediaStore.VOLUME_EXTERNAL)
            else -> MediaStore.Files.getContentUri(MediaStore.VOLUME_EXTERNAL)
        }
    }
    return context.contentResolver.insert(collection, values)
}

落地注意事项

  • Android 9及以下版本必须提前申请android.permission.WRITE_EXTERNAL_STORAGE运行时权限,否则即使路径填写正确,也会因为权限不足导致写入失败。
  • 不要把10及以上版本专属的IS_PENDING标记传入低版本的ContentValues,部分定制ROM会因为无法识别该列直接抛出参数异常。
  • 10及以上版本完成文件流写入后,需要把ContentValues里的IS_PENDING值更新为0,触发系统媒体扫描,让文件能被其他应用正常识别;低版本因为传入了完整的DATA路径,系统会自动完成媒体扫描,不需要额外调用扫描接口。
  • 不要因为部分ROM的MediaStore.Images/Video有路径兜底,就省略DATA字段的传入,该逻辑在原生低版本系统上同样会触发和音频集合一致的空指针异常。

内容的提问来源于stack exchange,提问作者Oleh Liskovych

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.11 10:57:03