Flutter：downloads_path_provider_28替代方案及路径错误解决

问题背景 #

开发的Flutter应用需要将用户生成内容（来自assets或Dart字符串）保存到Android系统下载目录，原使用的downloads_path_provider_28插件依赖废弃API，存在兼容性风险，尝试过flutter_file_downloader、file_saver、external_path等插件均未满足需求，手动写路径时出现文件路径错误。

错误代码 #

import 'dart:io' as io;

// import 'package:downloads_path_provider_28/downloads_path_provider_28.dart';

class KMLGenerator {
  static generateKML(data, filename) async {
    try {
      // final downloadsDirectory = await DownloadsPathProvider.downloadsDirectory;
      // Directory dir = Directory('/storage/emulated/0/Download');
      var path = "/storage/emulated/0/Download/";
      var savePath = io.Directory(path);
      // var savePath = downloadsDirectory?.path;
      final file = io.File("$savePath/$filename.kml");
      await file.writeAsString(data);
      return Future.value(file);
    } catch (e) {
      print(e);
      return Future.error(e);
    }
  }
}

错误信息 #

I/flutter ( 9449): FileSystemException: Cannot open file, path = 'Directory: '/storage/emulated/0/Download/'/SO2_Emission.kml' (OS Error: No such file or directory, errno = 2)

解决方案 #

1. 修复路径拼接错误 #

你直接将Directory对象转为字符串拼接，导致路径格式错误（出现Directory: '/xxx'的无效前缀）。正确做法是调用Directory对象的path属性获取纯路径字符串，同时避免手动硬编码路径（不同设备可能有差异）：

修正后的代码片段：

import 'dart:io' as io;
import 'package:path_provider/path_provider.dart'; // 使用官方维护的path_provider

class KMLGenerator {
  static Future<io.File> generateKML(dynamic data, String filename) async {
    try {
      // 获取Android下载目录的路径
      final downloadsDir = await getDownloadsDirectory();
      if (downloadsDir == null) {
        throw Exception("无法获取下载目录");
      }
      // 用path.join自动处理斜杠拼接问题
      final filePath = io.path.join(downloadsDir.path, "$filename.kml");
      final file = io.File(filePath);
      await file.writeAsString(data);
      return file;
    } catch (e) {
      print(e);
      rethrow;
    }
  }
}

2. 推荐替代插件：path_provider #

path_provider是Flutter官方维护的插件，支持获取各种系统目录（包括下载目录），兼容性强，无废弃API风险：

• 添加依赖：在pubspec.yaml中加入path_provider: ^2.1.2（或最新版本）
• 权限配置：Android端需在AndroidManifest.xml中添加对应存储权限（Android 13+需添加READ_MEDIA_*权限，Android 12及以下需WRITE_EXTERNAL_STORAGE）
• 核心方法：getDownloadsDirectory()直接返回下载目录的Directory对象，无需手动拼接路径

额外注意事项 #

• 避免硬编码路径：/storage/emulated/0/Download并非所有Android设备的标准下载路径，定制ROM可能有差异，用path_provider可适配所有设备
• 权限处理：Android 10及以上采用分区存储，保存到下载目录无需特殊权限，但读取其他目录需对应权限
• 异步方法规范：将generateKML声明为Future<io.File>类型，增强代码可读性与类型安全

内容的提问来源于stack exchange，提问作者Yash Raj Bharti