You need to enable JavaScript to run this app. Flutter Webview网页文件下载无响应问题技术咨询
优惠活动
大模型
产品
解决方案
定价
更多

Flutter Webview网页文件下载无响应问题技术咨询

解决方案

1. 为什么flutter_webview_plugin无法触发下载

flutter_webview_plugin早已停止维护,原生层未实现下载相关的事件监听逻辑,遇到Content-Disposition: attachment类型的响应不会将事件传递到Flutter层,因此点击下载按钮无响应是预期现象,不建议继续使用该包。

2. flutter_inappwebview下载监听未触发的修复方案

建议使用5.0.0以上的稳定版flutter_inappwebview,按以下步骤配置即可正常触发下载监听:

2.1 提前配置平台权限

  • 安卓端:在android/app/src/main/AndroidManifest.xml中添加存储、通知权限
    <!-- 安卓12及以下存储权限 -->
    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <!-- 安卓13及以上权限 -->
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
    
  • iOS端:在ios/Runner/Info.plist中添加存储权限说明
    <key>NSDocumentDirectoryUsageDescription</key>
    <string>需要存储权限保存下载文件</string>
    

2.2 正确注册下载监听回调

注意不要使用已废弃的onDownloadStart回调,需使用新版onDownloadStartRequest监听,示例代码如下:

InAppWebView(
  initialUrlRequest: URLRequest(url: Uri.parse("你的网页地址")),
  // 下载监听回调
  onDownloadStartRequest: (controller, downloadStartRequest) async {
    // 这里拿到下载请求的所有信息,包括url、文件名、文件类型等
    String downloadUrl = downloadStartRequest.url.toString();
    String? fileName = downloadStartRequest.suggestedFilename;
    
    // 方案1:调用系统浏览器下载,适配成本最低
    // 需提前引入url_launcher包
    // if (await canLaunchUrl(Uri.parse(downloadUrl))) {
    //   await launchUrl(Uri.parse(downloadUrl));
    // }

    // 方案2:配合flutter_downloader包实现应用内下载
    // 需提前引入flutter_downloader包并做初始化配置
    // await FlutterDownloader.enqueue(
    //   url: downloadUrl,
    //   savedDir: '你的本地存储目录',
    //   fileName: fileName,
    //   showNotification: true,
    //   openFileFromNotification: true,
    // );
  },
)

2.3 特殊场景兼容

如果前端使用Blob动态生成下载链接的场景没有触发下载监听,可额外添加资源请求拦截逻辑,判断响应头为下载类型时手动触发下载:

onLoadResource: (controller, resource) async {
  if (resource.response?.headers?.value("Content-Disposition")?.contains("attachment") == true) {
    // 手动调用下载逻辑
    String downloadUrl = resource.url.toString();
    // 后续处理逻辑同上
  }
}

内容的提问来源于stack exchange,提问作者Jashwanth Neela

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.09 16:36:01