Android 13中WebView内文件下载无响应问题求助

核心原因：WebView默认不处理文件下载请求 #

系统浏览器内置了下载处理逻辑，但WebView需要手动配置下载监听器，结合系统DownloadManager完成下载流程。以下是具体解决方案：

1. 给WebView设置DownloadListener #

在WebView初始化代码中添加下载监听器，捕获下载请求并调用系统DownloadManager执行下载：

webView.setDownloadListener(new DownloadListener() {
    @Override
    public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimeType, long contentLength) {
        // 构建下载请求
        DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));
        request.setMimeType(mimeType);
        
        // 自动解析文件名
        String filename = URLUtil.guessFileName(url, contentDisposition, mimeType);
        request.setTitle(filename);
        
        // 设置下载到公共Download目录（Android 13无需WRITE_EXTERNAL_STORAGE权限）
        request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, filename);
        
        // 显示下载通知
        request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        
        // 发起下载请求
        DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
        if (downloadManager != null) {
            downloadManager.enqueue(request);
            Toast.makeText(getApplicationContext(), "开始下载：" + filename, Toast.LENGTH_SHORT).show();
        }
    }
});

2. 配置WebView的必要参数 #

确保WebView启用支持下载的基础设置：

WebSettings webSettings = webView.getSettings();
webSettings.setJavaScriptEnabled(true); // 多数下载链接依赖JS触发
webSettings.setDomStorageEnabled(true); // 适配网页存储逻辑
webSettings.setAllowFileAccess(true); // 允许文件访问
webSettings.setAllowContentAccess(true);
// 适配iframe内的下载请求
webSettings.setAllowUniversalAccessFromFileURLs(true);
webSettings.setAllowFileAccessFromFileURLs(true);

3. 权限适配（Android 13及以上） #

• Android 13中WRITE_EXTERNAL_STORAGE已废弃，下载到公共目录（如Downloads）无需申请该权限，DownloadManager会自动处理存储权限。
• 若需下载到自定义目录，需申请MANAGE_EXTERNAL_STORAGE权限，但不推荐，优先使用系统公共目录。

4. 处理iframe跨域拦截（可选） #

如果iframe内的下载请求被跨域拦截，可通过WebViewClient放行：

webView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        view.loadUrl(request.getUrl().toString());
        return true;
    }
});

验证步骤 #

1. 确保WebView初始化时完成上述所有配置。
2. 点击iframe内的下载链接，检查是否弹出下载通知。
3. 前往系统下载管理器查看下载进度。

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