Android Studio中HTML应用WebView无法下载文件的解决方法

你这情况主要是几个关键设置没到位，我用大白话给你拆解，都是新手能跟着做的：

• 文件路径写错了
  你写的file/apk.apk是网页里的相对路径，但在Android的WebView环境里，本地文件得用专属的URI格式：

  • 如果APK放在项目的assets文件夹里（就是你放HTML的那个文件夹），路径要改成file:///android_asset/apk.apk
  • 如果APK存在手机的存储里（比如Download文件夹），得写完整绝对路径，比如file:///storage/emulated/0/Download/apk.apk
    先确认文件真的在你写的路径里，别放错文件夹了。

• WebView没开启下载功能
  就算你拿了存储权限，WebView默认不会自己处理下载请求，得加一段代码让它调用系统下载管理器。打开项目里的MainActivity.java（或者MainActivity.kt，看你用的是Java还是Kotlin），找到初始化WebView的地方，插入这段代码：

  // 给WebView设置下载监听器
  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);
          request.addRequestHeader("User-Agent", userAgent);
          request.setDescription("正在下载安装包");
          request.setTitle("apk.apk");
          // 把文件存到系统公共下载文件夹，不用额外权限
          request.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, "apk.apk");
          DownloadManager downloadManager = (DownloadManager) getSystemService(DOWNLOAD_SERVICE);
          if (downloadManager != null) {
              downloadManager.enqueue(request);
          }
      }
  });
  

  这段代码的作用就是：当你点HTML里的下载链接时，让系统自带的下载工具来接手下载，比HTML的download属性靠谱多了。

• 给APK加正确的类型标识
  有些时候WebView识别不了APK文件，你可以给标签加个类型属性，确保系统能认出这是安卓安装包：

  <a href="file:///android_asset/apk.apk" download type="application/vnd.android.package-archive">Install</a>
  

• Android 10及以上的存储兼容设置
  如果你的手机是Android 10或更高版本，除了存储权限，还要在AndroidManifest.xml文件里的<application>标签里加一行代码，不然可能找不到存储里的文件：

  <application 
      ...
      android:requestLegacyExternalStorage="true">