WebView长按下载图片未存入相册且缓存删除即消失的代码问题排查

我来帮你梳理下代码里的问题，你遇到的现象本质是文件存储路径不对+媒体库未及时扫描导致的，具体问题和修复方案如下：

一、核心问题分析 #

1. 长按下载未指定持久化存储路径
   你在长按菜单的下载逻辑里，只配置了allowScanningByMediaScanner和通知，但没有调用setDestinationInExternalPublicDir或setDestinationUri指定存储位置。此时DownloadManager会默认把文件存在系统临时下载缓存区（属于Download Manager的私有缓存），所以删除Download Manager缓存时文件会被一并清理，而且这个路径媒体库也不会主动识别。

2. 缺少主动触发媒体库扫描
   即使设置了allowScanningByMediaScanner，系统自动扫描的时机不确定，导致相册无法立刻看到下载的图片。

3. 下载前未校验权限状态
   虽然你在onCreate里做了权限检查，但如果用户之后撤销了权限，长按下载会静默失败，没有任何提示。

二、修复后的代码（关键部分修改） #

1. 修改长按下载的MenuItem点击逻辑 #

把你原来的onMenuItemClick方法替换成下面的代码：

@Override
public boolean onMenuItemClick(MenuItem menuItem) {
    String DownloadImageURL = webViewHitTestResult.getExtra();
    if(URLUtil.isValidUrl(DownloadImageURL)){
        // 下载前先校验存储权限
        if (ActivityCompat.checkSelfPermission(MainActivity.this, Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
            Toast.makeText(MainActivity.this, "需要存储权限才能保存图片哦", Toast.LENGTH_SHORT).show();
            checkPermission();
            return false;
        }

        // 生成文件名
        String fileName = URLUtil.guessFileName(DownloadImageURL, null, null);
        // 构建下载请求
        DownloadManager.Request request = new DownloadManager.Request(Uri.parse(DownloadImageURL));
        request.allowScanningByMediaScanner();
        request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        // 指定存储到公共Download目录（持久化路径，不会被Download Manager缓存清理影响）
        request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);

        DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
        final long downloadId = downloadManager.enqueue(request);

        // 下载完成后主动通知媒体库扫描文件，确保相册能及时显示
        downloadManager.addCompletedDownloadListener(new DownloadManager.OnDownloadCompletedListener() {
            @Override
            public void onDownloadCompleted(long id, long bytesDownloaded, long totalBytes) {
                if (id == downloadId) {
                    File downloadedFile = new File(Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOWNLOADS), fileName);
                    Uri fileUri = Uri.fromFile(downloadedFile);
                    Intent mediaScanIntent = new Intent(Intent.ACTION_MEDIA_SCANNER_SCAN_FILE);
                    mediaScanIntent.setData(fileUri);
                    sendBroadcast(mediaScanIntent);
                    Toast.makeText(MainActivity.this,"图片已保存到Download目录",Toast.LENGTH_LONG).show();
                }
            }
        });
    } else {
        Toast.makeText(MainActivity.this,"抱歉，下载链接无效",Toast.LENGTH_LONG).show();
    }
    return false;
}

2. AndroidManifest.xml兼容配置（针对Android 10+） #

如果你的应用要适配Android 10（API 29）及以上版本，需要添加以下配置来兼容旧的存储方式：

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

<application
    ...
    android:requestLegacyExternalStorage="true"> <!-- 适配Android 10的存储策略 -->
    ...
</application>

三、修改说明 #

• 指定持久化存储路径：用setDestinationInExternalPublicDir把文件存在系统公共的Download目录，这个路径不属于Download Manager的缓存，删除缓存不会影响文件，同时媒体库能识别到这个目录。
• 主动触发媒体扫描：下载完成后发送ACTION_MEDIA_SCANNER_SCAN_FILE广播，强制系统媒体库扫描新文件，相册就能立刻显示下载的图片。
• 权限二次校验：在下载前再次检查权限，避免权限被撤销后下载静默失败，同时给用户明确提示。

四、额外注意事项 #

• 对于Android 11（API 30）及以上版本，如果需要访问公共目录，除了requestLegacyExternalStorage，还可以考虑使用MediaStore API来存储文件，更符合Android 11+的存储规范。
• 测试时记得先卸载旧版本应用，再安装修改后的版本，避免缓存影响。

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