使用DownloadManager下载的Instagram Reel视频未在相册显示的问题排查

核心问题 #

• 扫描时机错误：DownloadManager是异步下载机制，你在调用enqueue后立刻执行目录扫描，此时视频还未下载完成，系统无法识别到新文件。
• 扫描范围不当：你扫描的是整个Download目录，而非刚下载的单个视频文件，部分系统媒体库不会主动索引子目录内的新增文件。
• Android 13+权限缺失：如果用户设备是Android 13及以上版本，未申请READ_MEDIA_VIDEO权限会导致相册无法读取下载的视频。

修复步骤 #

1. 监听下载完成广播，延迟扫描文件 #

DownloadManager的下载是后台异步执行的，必须等下载完成后再触发媒体扫描。注册广播接收器接收下载完成通知：

public class DownloadCompleteReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        if (DownloadManager.ACTION_DOWNLOAD_COMPLETE.equals(intent.getAction())) {
            long downloadId = intent.getLongExtra(DownloadManager.EXTRA_DOWNLOAD_ID, -1);
            DownloadManager dm = (DownloadManager) context.getSystemService(Context.DOWNLOAD_SERVICE);
            
            // 查询已下载文件的本地路径
            DownloadManager.Query query = new DownloadManager.Query();
            query.setFilterById(downloadId);
            Cursor cursor = dm.query(query);
            
            if (cursor.moveToFirst()) {
                int uriColumn = cursor.getColumnIndex(DownloadManager.COLUMN_LOCAL_URI);
                String localUri = cursor.getString(uriColumn);
                if (localUri != null) {
                    File videoFile = new File(Uri.parse(localUri).getPath());
                    // 扫描单个视频文件
                    scanSingleVideo(context, videoFile);
                }
            }
            cursor.close();
        }
    }
    
    private void scanSingleVideo(Context context, File file) {
        MediaScannerConnection.scanFile(context,
                new String[]{file.getAbsolutePath()},
                new String[]{"video/mp4"}, // 指定视频MIME类型，帮助媒体库精准识别
                (path, uri) -> Log.i("ScanLog", "视频扫描完成: " + path));
    }
}

在你的页面（Activity/Fragment）中注册接收器，注意在页面销毁时注销：

private DownloadCompleteReceiver downloadReceiver;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 其他初始化代码...
    downloadReceiver = new DownloadCompleteReceiver();
    registerReceiver(downloadReceiver, new IntentFilter(DownloadManager.ACTION_DOWNLOAD_COMPLETE));
}

@Override
protected void onDestroy() {
    super.onDestroy();
    unregisterReceiver(downloadReceiver);
}

2. 删除原代码中的无效扫描逻辑 #

把你原来在download方法里enqueue之后的所有扫描代码全部删除，这些代码要么时机不对，要么范围错误，无法触发有效的媒体库索引。

3. 补全权限配置 #

• Android 12及以下：在Manifest中声明权限，并在运行时申请：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>

• Android 13+：添加视频读取权限，同样需要运行时申请：

<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />

4. 确认文件路径与后缀 #

确保destinationPath是包含文件名和正确后缀的完整相对路径，比如：

// 示例：给文件名添加.mp4后缀，保证相册能识别为视频
String destPath = "/InstaReel/" + filename + ".mp4";

缺少标准视频后缀的文件，部分相册应用不会将其识别为视频。

额外提醒 #

• 不要使用ACTION_MEDIA_MOUNTED广播，Android 4.4+之后普通应用发送该广播无效，仅系统应用有权限触发。
• 测试时尽量覆盖不同品牌的设备，部分厂商的相册对媒体扫描的响应逻辑存在差异。

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