Android WebView下载视频格式异常无法播放问题求助

我之前也碰到过一模一样的情况——WebView里点链接下的视频显示格式未知没法播放，但Chrome用同一个链接下载就完全正常。其实核心问题在于WebView默认的下载逻辑没有正确解析服务器返回的文件元信息（比如文件名、MIME类型），而Chrome对这些头信息的处理要成熟得多。

下面是我亲测有效的解决方案：

1. 替换默认的DownloadListener，用系统DownloadManager处理下载 #

原代码里的DownloadListener只是空实现，这肯定不行。我们需要手动解析文件名和MIME类型，然后交给Android系统的DownloadManager来处理，它会自动帮我们搞定文件格式识别的问题。

完整代码示例：

WebView webview = (WebView) findViewById(R.id.web1);
webview.setWebViewClient(new WebViewClient());
webview.loadUrl("your_url_here");

webview.setDownloadListener(new DownloadListener() {
    @Override
    public void onDownloadStart(String url, String userAgent, String contentDisposition, String mimeType, long contentLength) {
        // 利用系统工具类解析文件名，优先从Content-Disposition头获取，没有的话从URL截取
        String fileName = URLUtil.guessFileName(url, contentDisposition, mimeType);
        
        // 初始化DownloadManager请求
        DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));
        request.setMimeType(mimeType);
        
        // 设置下载请求的头信息（模拟浏览器的User-Agent，避免服务器拒绝）
        request.addRequestHeader("User-Agent", userAgent);
        
        // 设置下载通知的显示内容
        request.setDescription("视频下载中...");
        request.setTitle(fileName);
        request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
        
        // 指定下载文件的存储路径（这里存在公共下载目录）
        request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);
        
        // 获取DownloadManager实例并发起下载
        DownloadManager downloadManager = (DownloadManager) getSystemService(Context.DOWNLOAD_SERVICE);
        if (downloadManager != null) {
            downloadManager.enqueue(request);
        }
        
        // 给用户一个反馈
        Toast.makeText(getApplicationContext(), "开始下载: " + fileName, Toast.LENGTH_SHORT).show();
    }
});

2. 必要的权限配置 #

别忘了在AndroidManifest.xml里添加权限：

<!-- 网络权限 -->
<uses-permission android:name="android.permission.INTERNET"/>
<!-- 存储权限（Android 10及以上可以不用，但低版本需要） -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28"/>

如果你的应用目标SDK是23+（Android 6.0以上），还需要动态申请WRITE_EXTERNAL_STORAGE权限，否则下载会失败。

3. 额外的排查点 #

如果还是不行，可以检查这两个地方：

• 服务器返回的Content-Disposition头是否包含正确的文件名（比如attachment; filename=xxx.mp4），如果服务器没返回这个，URLUtil.guessFileName会从URL里截取，这时候要确保URL里带有正确的文件扩展名
• 如果MIME类型不准确，也可以手动指定，比如明确设置request.setMimeType("video/mp4");（前提是你确定视频格式是MP4）

这样处理后，下载的视频文件就会有正确的扩展名，系统也能识别出视频格式，正常播放了。

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