You need to enable JavaScript to run this app. 使用flutter_downloader下载文件触发setPubRootDirectories错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

使用flutter_downloader下载文件触发setPubRootDirectories错误如何解决

Error handling 'serviceExtension' custom request: method not available: ext.flutter.inspector.setPubRootDirectories

该报错是Flutter调试服务扩展与后台Isolate通信冲突导致,flutter_downloader执行下载时会开启独立后台Isolate,而firebase_messaging也会占用后台Isolate处理推送事件,二者与主Isolate的调试服务扩展通信时产生冲突,该报错仅出现在debug/profile模式下,属于非致命调试警告,不会影响release包的正常功能。

解决步骤

  • 第一步:优先验证release包表现
    直接打release包测试下载功能,release模式会自动禁用Flutter Inspector等调试工具,不会触发该报错,若release包下载功能正常,可忽略debug模式下的该警告。
  • 第二步:优化Isolate回调配置
    在main.dart初始化逻辑中添加调试模式下的隔离配置,避免后台Isolate调用调试扩展:
    import 'package:flutter/foundation.dart';
    import 'package:flutter_downloader/flutter_downloader.dart';
    
    void main() async {
      WidgetsFlutterBinding.ensureInitialized();
      // 初始化Firebase
      await Firebase.initializeApp();
      // 初始化FlutterDownloader
      await FlutterDownloader.initialize(
        debug: kDebugMode, // 仅调试模式开启日志
        ignoreSsl: true, // 按需配置是否忽略SSL证书错误
      );
      // 注册空回调避免调试模式下的服务扩展请求
      if (kDebugMode) {
        FlutterDownloader.registerCallback((id, status, progress) {});
      }
      runApp(const MyApp());
    }
    
  • 第三步:修复现有下载代码的潜在异常
    你当前的代码未判空存储目录、未适配高版本Android权限,修改如下:
    IconButton(
      icon: Icon(Icons.download),
      onPressed: () async {
        // Android 13+需要额外申请通知权限用于显示下载进度通知
        if (Platform.isAndroid && await DeviceInfoPlugin().androidInfo.version.sdkInt >= 33) {
          await Permission.postNotifications.request();
        }
        final status = await Permission.storage.request();
        if (status.isGranted) {
          final externalDir = await getExternalStorageDirectory();
          // 判空避免空指针异常
          if (externalDir == null) {
            print("无法获取有效存储目录");
            return;
          }
          final id = await FlutterDownloader.enqueue(
            url: files[i].file,
            fileName: 'filename',
            savedDir: externalDir.path,
            showNotification: true,
            openFileFromNotification: true,
          );
        } else {
          print('Permission denied');
        }
      },
    )
    
  • 第四步:校验依赖版本兼容性
    确保三个核心依赖版本匹配:
    • flutter_downloader >= 1.10.2
    • firebase_messaging >= 14.0.0
    • Flutter SDK >= 3.0.0
      版本不匹配时执行flutter pub upgrade升级到最新兼容版本即可。

内容的提问来源于stack exchange,提问作者Barnett Temwa Msiska

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.19 09:15:03