Android Studio开发的WebView应用无法下载内容问题咨询

这问题我碰到过好多次了，WebView和原生浏览器的行为完全不一样——浏览器自带了完整的下载管理逻辑，但WebView默认不会处理下载请求，得咱们手动写代码实现才行。下面一步步给你解决：

核心问题：WebView未绑定下载监听器 #

WebView本身没有内置下载处理能力，必须通过setDownloadListener方法绑定一个下载监听器，才能捕获用户的下载请求。

代码示例：添加DownloadListener #

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);
        request.setDescription("正在下载文件...");

        // 根据Android版本设置下载路径
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
            // Android 10+ 适配Scoped Storage，保存到公共下载目录
            request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, filename);
            request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        } else {
            // 低版本直接指定公共下载目录
            request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, filename);
            request.allowScanningByMediaScanner();
            request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        }

        // 发起下载请求
        DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
        if (downloadManager != null) {
            downloadManager.enqueue(request);
            Toast.makeText(getApplicationContext(), "开始下载", Toast.LENGTH_SHORT).show();
        }
    }
});

必须处理的权限问题 #

下载需要存储权限，不同Android版本的权限要求有差异：

1. 静态权限声明（AndroidManifest.xml） #

在<manifest>标签内添加必要权限：

<!-- Android 9及以下需要的存储权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<!-- 网络权限（下载依赖HTTP/HTTPS时必须） -->
<uses-permission android:name="android.permission.INTERNET" />
<!-- Android 10+ 访问公共目录的可选权限（需保存到公共文件夹时添加） -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" android:minSdkVersion="30" />

2. 动态权限请求（Android 6.0+） #

如果应用目标版本是Android 6.0（API 23）及以上，必须在代码中动态申请存储权限：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
    if (checkSelfPermission(Manifest.permission.WRITE_EXTERNAL_STORAGE) != PackageManager.PERMISSION_GRANTED) {
        requestPermissions(new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE}, 1001);
    }
}

记得重写onRequestPermissionsResult方法，处理用户的权限申请结果。

Android 10+的特殊注意事项 #

Android 10引入了Scoped Storage机制，默认限制应用访问公共存储目录。如果要保存到公共下载文件夹，除了配置上述权限，还需要确保下载请求使用setDestinationInExternalPublicDir或适配MediaStore API；如果仅保存到应用私有目录（getExternalFilesDir），则不需要额外权限。

其他可能的坑 #

• 确认WebView启用了JavaScript：如果下载链接是通过JS触发的，必须开启JS支持：webSettings.setJavaScriptEnabled(true);
• 检查HTTPS证书信任问题：如果下载链接是HTTPS，WebView可能因证书不信任拒绝请求，可配置SSL错误处理（注意：仅测试环境建议忽略错误，正式环境需确保证书合法）。

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