如何阻止WebView下载文件时被默认媒体播放器自动打开？

这个问题我之前也碰到过，踩过类似的坑——核心原因是WebView默认会把下载请求抛给系统处理，系统会根据文件的MIME类型自动匹配默认应用（比如你的媒体文件就被播放器直接接管打开了）。要解决这个问题，关键是拦截WebView的下载请求，手动用系统的DownloadManager来处理下载流程，这样就能完全掌控下载行为，不会被系统应用打断。

1. 给WebView设置DownloadListener拦截请求 #

在你初始化WebView的代码里，添加一个DownloadListener，把所有下载请求都拦截下来自己处理：

webView.setDownloadListener(new DownloadListener() {
    @Override
    public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimeType, long contentLength) {
        // 跳过系统默认处理，调用我们自己的下载方法
        startFileDownload(url, userAgent, contentDisposition, mimeType);
    }
});

2. 用DownloadManager实现自定义下载逻辑 #

创建一个专门的方法，用Android系统提供的DownloadManager来发起下载。这个组件是专门处理后台下载的，会直接把文件存到你指定的目录，不会自动调用其他应用打开：

private void startFileDownload(String url, String userAgent, String contentDisposition, String mimeType) {
    // 从contentDisposition或URL里解析出文件名
    String fileName = URLUtil.guessFileName(url, contentDisposition, mimeType);
    
    // 构建下载请求
    DownloadManager.Request downloadRequest = new DownloadManager.Request(Uri.parse(url));
    // 带上浏览器的UserAgent，避免部分服务器拒绝请求
    downloadRequest.addRequestHeader("User-Agent", userAgent);
    // 允许在移动网络和WiFi下下载（可根据需求调整）
    downloadRequest.setAllowedNetworkTypes(DownloadManager.Request.NETWORK_MOBILE | DownloadManager.Request.NETWORK_WIFI);
    // 设置下载通知：下载中和完成时都显示通知
    downloadRequest.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    
    // 设置文件保存路径（区分Android版本处理权限）
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
        // Android 10及以上，直接存到公共下载目录，无需申请WRITE_EXTERNAL_STORAGE权限
        downloadRequest.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
    } else {
        // Android 9及以下，需要提前申请WRITE_EXTERNAL_STORAGE权限
        downloadRequest.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
    }
    
    // 获取DownloadManager服务并发起下载
    DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
    if (downloadManager != null) {
        downloadManager.enqueue(downloadRequest);
        Toast.makeText(this, "文件已开始下载，可在通知栏查看进度", Toast.LENGTH_SHORT).show();
    }
}

3. 权限适配（针对旧版本Android） #

如果你的应用需要兼容Android 9（API 28）及以下版本，记得在AndroidManifest.xml里添加存储权限：

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

并且要在运行时动态申请这个权限，否则DownloadManager无法将文件保存到外部存储。

4. 优化WebView配置（可选但推荐） #

确保你的WebView开启了必要的设置，避免下载请求被意外拦截：

WebSettings webSettings = webView.getSettings();
// 如果下载按钮是通过JavaScript触发的，必须开启JS支持
webSettings.setJavaScriptEnabled(true);
// 允许WebView访问文件
webSettings.setAllowFileAccess(true);
// 开启DOM存储，适配部分依赖本地存储的网站
webSettings.setDomStorageEnabled(true);

通过设置DownloadListener，我们完全接管了WebView的下载流程，不再让系统默认处理请求。而DownloadManager是Android官方提供的下载组件，它的职责就是安全可靠地完成文件下载，只会在下载完成后通过通知告知用户，不会自动调用任何第三方应用打开文件，完美解决了你遇到的被媒体播放器自动打开的问题。

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