Android 11及以上SD卡重命名媒体文件后MediaStore无法通过ContentResolver更新

问题核心原因 #

1. API 30+ 字段限制：MediaStore的MediaStore.Images.Media.DATA字段在Android 11及以上变为只读，原代码中试图通过ContentResolver.update()修改该字段完全无效。
2. Uri 匹配错误：可移除SD卡对应的媒体库Uri应为MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_REMOVABLE)，而非VOLUME_EXTERNAL（后者对应内部共享存储），原代码用错Uri导致无法匹配到SD卡上的媒体条目。
3. 文件操作与媒体库不同步：直接调用File.renameTo()修改SD卡文件后，媒体库不会自动同步文件变化，手动更新的方式也不符合Android 11+的存储规范。

推荐解决方案：使用MediaStore API直接重命名（符合Android 11+规范） #

通过MediaStore提供的API完成重命名，系统会自动同步文件操作与媒体库数据，无需手动处理扫描或字段修改：

String oldFileName = "20740534.jpg";
String newFileName = "travelPlan.jpg";
// 替换为你的SD卡卷名，可通过StorageKit获取
String sdCardVolumeName = "0COB-3B10";

// 获取可移除SD卡的图片媒体Uri
Uri imagesUri = MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_REMOVABLE);

// 查询旧文件对应的媒体条目ID
String selection = MediaStore.Images.Media.DISPLAY_NAME + "=? AND " + MediaStore.Images.Media.RELATIVE_PATH + "=?";
String[] selectionArgs = {oldFileName, "Pictures/"};
Cursor cursor = getContentResolver().query(imagesUri, new String[]{MediaStore.Images.Media._ID}, selection, selectionArgs, null);

if (cursor != null && cursor.moveToFirst()) {
    long mediaId = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
    Uri targetUri = ContentUris.withAppendedId(imagesUri, mediaId);

    ContentValues values = new ContentValues();
    values.put(MediaStore.Images.Media.DISPLAY_NAME, newFileName);
    values.put(MediaStore.Images.Media.TITLE, getForeString(newFileName, '.'));
    
    // 执行更新，系统自动处理文件重命名与媒体库同步
    int updatedRows = getContentResolver().update(targetUri, values, null, null);
    if (updatedRows > 0) {
        // 更新成功逻辑
    }
    cursor.close();
}

兼容旧代码方案：文件重命名后触发媒体库扫描 #

如果必须保留File.renameTo()的操作逻辑，需触发媒体库扫描新文件并删除旧的媒体条目，避免数据不一致：

boolean success = img.renameTo(file);
if (success) {
    // 扫描新文件，让媒体库识别到文件变化
    MediaScannerConnection.scanFile(this, new String[]{newPath}, null, (path, uri) -> {
        // 扫描完成后删除旧路径对应的媒体条目
        Uri imagesUri = MediaStore.Images.Media.getContentUri(MediaStore.VOLUME_EXTERNAL_REMOVABLE);
        getContentResolver().delete(imagesUri, MediaStore.Images.Media.DATA + "=?", new String[]{oldPath});
    });
}

关键注意事项 #

• 即使targetSdkVersion为28，运行在Android 11+设备上时也需遵循API 30+的MediaStore字段限制，禁止修改DATA字段。
• 操作可移除SD卡的媒体文件时，必须使用VOLUME_EXTERNAL_REMOVABLE对应的Uri，否则无法访问SD卡上的媒体库条目。

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