Android 8.0/7.0设备WebView下载PDF时获取index.php问题求助

这个问题其实是不同Android版本对下载请求的文件名解析逻辑差异导致的——Android 8.0及以上的系统下载管理器，在处理没有.pdf扩展名的URL时，会默认用URL路径的最后一段（也就是index.php）作为文件名，而低版本系统会自动从响应头里提取正确的PDF文件名。

要解决这个问题，核心思路是手动拦截WebView的下载请求，自己解析正确的文件名，再交给下载管理器执行下载，而不是依赖系统自动推断。下面是具体的实现步骤和代码：

1. 替换默认的DownloadListener，手动处理下载逻辑 #

原本的WebView下载监听可能直接调用系统下载管理器，现在我们要改成先解析文件名再执行下载：

webView.setDownloadListener((url, userAgent, contentDisposition, mimeType, contentLength) -> {
    // 用异步任务处理网络请求（避免主线程阻塞）
    new AsyncTask<Void, Void, String>() {
        @Override
        protected String doInBackground(Void... voids) {
            try {
                // 发起HEAD请求获取响应头（比GET更高效，不用下载文件内容）
                URLConnection connection = new URL(url).openConnection();
                connection.setRequestProperty("User-Agent", userAgent);
                // 从响应头里获取Content-Disposition和Content-Type
                String disposition = connection.getHeaderField("Content-Disposition");
                String type = connection.getContentType();
                return parseFileName(url, disposition, type);
            } catch (IOException e) {
                e.printStackTrace();
                return null;
            }
        }

        @Override
        protected void onPostExecute(String fileName) {
            // 如果解析失败，用备用逻辑生成文件名
            if (fileName == null) {
                fileName = parseFileName(url, contentDisposition, mimeType);
            }
            // 执行下载
            startFileDownload(url, fileName, mimeType, userAgent);
        }
    }.execute();
});

2. 实现文件名解析逻辑 #

这个方法会优先从Content-Disposition响应头提取文件名，没有的话再从URL或MIME类型生成：

private String parseFileName(String url, String contentDisposition, String mimeType) {
    // 优先从Content-Disposition头解析文件名
    if (contentDisposition != null) {
        // 匹配filename参数的正则表达式
        String filenameRegex = "filename[^;=]*=((['\"]).*?\\2|[^;]*)";
        Pattern pattern = Pattern.compile(filenameRegex, Pattern.CASE_INSENSITIVE);
        Matcher matcher = pattern.matcher(contentDisposition);
        if (matcher.find()) {
            String fileName = matcher.group(1).replace("\"", "").replace("'", "");
            // 如果文件名没有扩展名，根据MIME类型补充（比如application/pdf对应.pdf）
            if (!fileName.contains(".") && mimeType != null) {
                String extension = MimeTypeMap.getSingleton().getExtensionFromMimeType(mimeType);
                if (extension != null) {
                    fileName += "." + extension;
                }
            }
            return fileName;
        }
    }

    // 如果没有Content-Disposition，从URL提取或生成默认文件名
    String fileName = Uri.parse(url).getLastPathSegment();
    // 处理文件名是index.php或无扩展名的情况
    if (fileName == null || fileName.equals("index.php") || !fileName.contains(".")) {
        if ("application/pdf".equals(mimeType)) {
            fileName = "document_" + System.currentTimeMillis() + ".pdf";
        } else {
            fileName = "file_" + System.currentTimeMillis();
        }
    }
    return fileName;
}

3. 执行下载的工具方法 #

把解析好的文件名传给DownloadManager，确保下载时使用正确的名称：

private void startFileDownload(String url, String fileName, String mimeType, String userAgent) {
    DownloadManager.Request request = new DownloadManager.Request(Uri.parse(url));
    // 设置MIME类型，确保系统能正确识别文件
    request.setMimeType(mimeType);
    // 带上原WebView的User-Agent，避免服务器拒绝请求
    request.addRequestHeader("User-Agent", userAgent);
    // 设置通知栏显示的信息
    request.setTitle(fileName);
    request.setDescription("正在下载PDF文件...");
    request.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED);
    // 指定下载路径（公共下载目录）
    request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName);

    // 获取下载管理器服务并执行下载
    DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
    if (downloadManager != null) {
        downloadManager.enqueue(request);
        Toast.makeText(this, "开始下载：" + fileName, Toast.LENGTH_SHORT).show();
    }
}

额外注意事项 #

• 权限配置：确保你的Manifest里添加了必要的权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <!-- Android 10及以下需要存储权限，Android 11+用Scoped Storage，DownloadManager会自动处理 -->
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />
  

• 异步处理：网络请求必须放在子线程里，上面用了AsyncTask，你也可以用Coroutine或RxJava替代，避免主线程阻塞。

这样修改后，不管URL有没有.pdf扩展名，Android 8.0+设备都能正确下载并保存为PDF文件了。

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