Android Q下如何可靠触发媒体扫描以更新MediaStore记录？

我完全懂你在Android Q上折腾媒体文件更新的痛苦——Scoped Storage（作用域存储）的变化加上file:/// URI的逐步弃用，把很多老方法都直接废掉了，官方文档又没跟上细节，尤其是音频文件修改后同步MediaStore这块，确实踩了不少坑。

先梳理下你遇到的核心问题：修改音频文件后，没法让MediaStore可靠更新记录，试过的几种方法要么部分生效，要么直接失效，而且还得兼顾主存储和辅助存储的情况。下面给你分享几个经过验证的可靠方案：

一、针对已修改的现有文件：更新而非插入/扫描 #

你之前尝试手动插入MediaStore的思路错了——修改已有文件时，应该用update方法更新对应记录，而不是插入新条目，这才是符合Android Q规范的做法。

步骤1：获取目标文件的MediaStore URI #

首先你需要拿到对应文件的content:// URI（不管是主存储还是辅助存储）：

• 如果你的APP是通过MediaStore查询得到的文件，直接复用那个URI就行；
• 如果是从文件路径转换，需要先查询MediaStore找到对应ID：

// 示例：从文件路径获取MediaStore URI
public Uri getMediaUriFromPath(Context context, String filePath, String volumeName) {
    String[] projection = {MediaStore.Audio.Media._ID};
    String selection = MediaStore.Audio.Media.DATA + "=?";
    String[] selectionArgs = {filePath};
    
    // 针对不同存储卷，使用对应的collection URI
    Uri collection = MediaStore.Audio.Media.getContentUri(volumeName);
    Cursor cursor = context.getContentResolver().query(
            collection,
            projection,
            selection,
            selectionArgs,
            null);
    
    Uri mediaUri = null;
    if (cursor != null && cursor.moveToFirst()) {
        long id = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Audio.Media._ID));
        mediaUri = ContentUris.withAppendedId(collection, id);
        cursor.close();
    }
    return mediaUri;
}

注：volumeName主存储用MediaStore.VOLUME_EXTERNAL_PRIMARY，辅助存储用对应的卷标识（比如"0000-0000"），可以通过StorageManager获取所有可用存储卷。

步骤2：更新MediaStore记录并通知系统 #

拿到URI后，直接更新对应列值，再通知系统刷新：

// 假设你已经准备好了修改后的AudioFileContentValues
Uri mediaUri = getMediaUriFromPath(context, filePath, volumeName);
if (mediaUri != null) {
    // 更新MediaStore中的记录
    int rowsUpdated = context.getContentResolver().update(
            mediaUri,
            AudioFileContentValues,
            null,
            null);
    
    // 强制通知系统MediaStore内容变化，确保界面刷新
    context.getContentResolver().notifyChange(mediaUri, null);
}

二、针对新增文件：先获取URI再写入 #

如果是你的APP生成新的音频文件，不要先创建文件再扫描，而是先通过MediaStore插入获取URI，再用这个URI写入内容，系统会自动同步MediaStore：

// 示例：新增音频文件到指定存储卷
public Uri createNewAudioFile(Context context, String fileName, String volumeName) {
    Uri collection = MediaStore.Audio.Media.getContentUri(volumeName);
    ContentValues values = new ContentValues();
    values.put(MediaStore.Audio.Media.DISPLAY_NAME, fileName);
    values.put(MediaStore.Audio.Media.MIME_TYPE, "audio/mpeg");
    // 指定文件相对路径，比如放在Music下的自定义文件夹
    values.put(MediaStore.Audio.Media.RELATIVE_PATH, "Music/MyAudioApp");
    
    Uri newUri = context.getContentResolver().insert(collection, values);
    // 用返回的URI写入文件内容
    if (newUri != null) {
        try (OutputStream os = context.getContentResolver().openOutputStream(newUri)) {
            // 写入你的音频文件内容
        } catch (IOException e) {
            e.printStackTrace();
            // 写入失败，删除插入的空记录
            context.getContentResolver().delete(newUri, null, null);
            newUri = null;
        }
    }
    return newUri;
}

三、为什么你之前的方法失效？ #

给你解释下之前尝试的几种方法在Android Q下的问题：

• MediaScannerService：Android Q开始仅支持主存储的file:// URI，完全不兼容辅助存储和content:// URI，而且扫描逻辑被Scoped Storage限制，没法可靠同步；
• ACTION_MEDIA_SCANNER_SCAN_FILE广播：这个API在Android Q已经被正式弃用，Scoped Storage下系统直接忽略这类广播，完全失效；
• 手动插入MediaStore：你是修改已有文件，插入操作只会新增一条重复记录，而且getContentUriForPath被弃用后，辅助存储的插入因为权限限制直接失败，自然不会有持久化记录。

最后补充权限注意事项 #

• Android Q/Q+：需要申请READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限；
• Android 13+：权限拆分，需要申请READ_MEDIA_AUDIO和WRITE_MEDIA_AUDIO权限；
• 辅助存储访问：不需要额外的MANAGE_EXTERNAL_STORAGE权限，通过MediaStore的卷URI即可正常访问。

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