使用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
相关产品推荐
相关产品推荐

