Flutter Firebase附件下载报PathNotFoundException错误求解决方案

核心问题分析 #

下载时触发PathNotFoundException，通常是保存路径不存在、文件名/后缀解析错误或权限配置缺失导致的，结合场景逐一排查：

1. 确保保存目录存在 #

写入文件前必须先创建目标路径的父目录，否则会因目录不存在报错。修改代码：

// 获取保存目录
Directory appDocDir = await getApplicationDocumentsDirectory();
String fileName = // 正确解析的文件名
String savePath = '${appDocDir.path}/$fileName';

// 递归创建父目录（如果不存在）
await Directory(savePath).parent.create(recursive: true);

// 执行文件写入操作
var response = await http.get(Uri.parse(fileUrl));
await File(savePath).writeAsBytes(response.bodyBytes);

2. 修正文件后缀/文件名解析逻辑 #

Firebase Storage返回的URL可能带有查询参数（如?token=xxx），直接分割最后一个.会拿到错误后缀。先解析URL去掉参数：

Uri fileUri = Uri.parse(firestoreFileUrl);
// 从URL路径中提取纯文件名（不含参数）
String rawFileName = fileUri.pathSegments.last;
// 分割后缀
String fileExtension = rawFileName.split('.').last;
// 最终文件名保留原名称
String targetFileName = rawFileName;

3. 检查Android权限配置 #

• 在AndroidManifest.xml中添加存储权限（针对Android 10以下）：

  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="28"/>
  

• Android 10+需开启兼容模式，在application标签添加：

  android:requestLegacyExternalStorage="true"
  

  若使用Android 13+，如需保存到公共目录，需额外申请READ_MEDIA_IMAGES/READ_MEDIA_VIDEO等权限；若仅保存到应用私有目录（如getApplicationDocumentsDirectory()返回的路径），无需额外权限。

4. 验证savePath合法性 #

打印savePath后确认：

• 路径格式正确（如Android下应为/data/user/0/com.xxx.app/app_flutter/xxx.pdf）
• 路径对应的目录确实存在，可通过Directory(savePath).parent.exists()验证

修正后的完整下载按钮示例代码 #

Future<void> downloadFile(String fileUrl) async {
  try {
    // 解析URL并提取文件名
    Uri fileUri = Uri.parse(fileUrl);
    String fileName = fileUri.pathSegments.last;

    // 获取应用私有文档目录
    Directory appDocDir = await getApplicationDocumentsDirectory();
    String savePath = '${appDocDir.path}/$fileName';

    // 创建父目录
    await Directory(savePath).parent.create(recursive: true);

    // 下载文件
    var response = await http.get(Uri.parse(fileUrl));
    if (response.statusCode == 200) {
      await File(savePath).writeAsBytes(response.bodyBytes);
      // 提示下载成功
      ScaffoldMessenger.of(context).showSnackBar(
        SnackBar(content: Text('文件已保存至: $savePath')),
      );
    } else {
      throw Exception('下载失败，状态码: ${response.statusCode}');
    }
  } catch (e) {
    ScaffoldMessenger.of(context).showSnackBar(
      SnackBar(content: Text('下载出错: ${e.toString()}')),
    );
  }
}

内容的提问来源于stack exchange，提问作者Dasun Dola