Flutter Android端使用image_picker选图库图片复制到本地存储报错如何解决

你的报错核心由几个常见问题共同导致：

• 目标路径写法不规范：你写的storage/emulated/0/$image.name是相对路径，没有加开头的/，系统无法识别为公共存储的绝对路径，同时路径拼接逻辑会导致出现连续双斜杠，路径合法性校验不通过
• 未做目标目录存在性校验：如果目标目录不存在，直接执行复制操作就会抛出找不到文件/目录的异常
• 缺失空安全判断：picker.pickImage如果用户取消选图会返回null，直接访问image.path存在空安全崩溃风险
• 未提前申请存储权限：Android高版本读写公共存储目录需要动态申请权限，权限未授予也会导致读写失败

1. 前置权限配置 #

在android/app/src/main/AndroidManifest.xml中添加对应权限声明：

<!-- Android 12及以下存储权限 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<!-- Android 13及以上图片读取权限 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />

操作前使用permission_handler类库动态申请对应权限，确认权限已授予再执行选图、保存逻辑。

2. 代码修复 #

补全空判断、目录校验逻辑，规范路径写法：

onPressed: () async {
  // 此处先插入动态申请权限逻辑，确认权限通过再执行后续操作
  final XFile? image = await picker.pickImage(source: ImageSource.gallery);
  // 用户取消选图直接返回
  if (image == null) return;
  File tempFile = File(image.path);
  // 定义目标目录，优先建议创建应用专属文件夹，避免污染根目录
  final targetDir = Directory('/storage/emulated/0/你的应用专属文件夹名/');
  // 目录不存在则递归创建
  if (!await targetDir.exists()) {
    await targetDir.create(recursive: true);
  }
  // 拼接合法的完整目标路径
  final targetPath = '${targetDir.path}${image.name}';
  try {
    final savedFile = await tempFile.copy(targetPath);
    // 此处插入保存成功后的业务逻辑
  } catch (e) {
    // 此处插入异常捕获处理逻辑
    print('图片保存失败：$e');
  }
}

如果你的需求是把图片保存到系统相册，更推荐直接使用gallery_saver、image_gallery_saver这类封装好的类库，无需自己适配不同Android版本的目录规则，兼容性更好。

内容的提问来源于stack exchange，提问作者Mudasir Habib