Flutter Android端无法删除内部存储文件问题求助

问题复现 #

执行删除文件操作前已检查文件存在，但仍抛出以下错误：

[ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: FileSystemException: Cannot delete file, path = '/storage/emulated/0/Pictures/Image Description (1).jpg' (OS Error: No such file or directory, errno = 2)

删除代码如下：

await Future.forEach(_selectedFile, (element) async {
      if (await element?.exists() ?? false) {
        await element?.delete();  // 报错行
      }
    });

解决方案 #

1. 排查路径一致性与异步竞态问题 #

• 打印文件路径确认：在exists()前输出element?.path，和报错路径逐一对比，检查是否存在隐形字符、大小写差异（Android路径虽不区分大小写，但部分场景可能出现编码匹配问题）。
• 处理竞态异常：exists()到delete()的间隙，文件可能被系统或其他应用删除/移动，添加try-catch捕获异常避免崩溃：

  await Future.forEach(_selectedFile, (element) async {
    final filePath = element?.path;
    if (filePath == null) return;
    final file = File(filePath);
    if (await file.exists()) {
      try {
        await file.delete();
      } catch (e) {
        print("删除失败：$filePath，错误：$e");
      }
    }
  });
  

2. 适配Android Scoped Storage限制 #

Android 10+启用Scoped Storage机制，直接通过File类操作公共目录（如Pictures）的文件可能受限，建议通过MediaStore API完成删除：

• 可使用media_store第三方库简化操作，先在pubspec.yaml添加依赖，再实现删除逻辑：

  import 'package:media_store/media_store.dart';
  
  Future<void> deleteFileViaMediaStore(String filePath) async {
    final where = "${MediaStore.Images.Media.DATA} = ?";
    final whereArgs = [filePath];
    await MediaStore.delete(
      MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
      where: where,
      whereArgs: whereArgs,
    );
  }
  

• 在之前的try-catch块中，将此方法作为File.delete()的降级方案调用。

3. 确认权限适配 #

• Android 13+需申请READ_MEDIA_IMAGES权限，而非旧版的READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE。
• 若需操作任意目录下的文件，需申请MANAGE_EXTERNAL_STORAGE权限（仅适用于特殊场景，需通过Google Play审核）。

4. 验证文件状态 #

• 确认目标是文件而非目录：添加await file.isFile()检查，若为目录需调用delete(recursive: true)完成递归删除。

内容的提问来源于stack exchange，提问作者Harsh Sureja