Flutter外部存储访问权限授予及权限拒绝问题解决

你遇到的FileSystemException: Permission denied问题，本质是Android 10（API 29）及以上的分区存储机制限制，加上只添加了静态权限但没在运行时动态申请权限导致的。下面一步步帮你搞定：

1. 先搞定运行时动态权限申请 #

从Android 6.0开始，光在AndroidManifest.xml里加权限声明没用，必须在App运行时主动请求用户授权。推荐用permission_handler包来简化流程：

• 先在pubspec.yaml里加依赖：

dependencies:
  permission_handler: ^10.2.0 # 建议用最新版本

• 然后写个权限请求的方法，在访问存储前调用：

import 'package:permission_handler/permission_handler.dart';

Future<bool> getStoragePermissions() async {
  var storageStatus = await Permission.storage.status;
  if (!storageStatus.isGranted) {
    final result = await Permission.storage.request();
    return result.isGranted;
  }
  return true;
}

只有当这个方法返回true时，再去执行目录遍历操作。

2. 适配Android 10+的分区存储 #

Android 10默认开启分区存储，App只能访问自己的专属目录和媒体文件。如果要做类似文件管理器的全目录访问，得做额外适配：

• 对于Android 10（API 29），在AndroidManifest.xml的application标签里加个属性，兼容旧的存储模式：

<application
  android:requestLegacyExternalStorage="true"
  ...>
  <!-- 其他配置 -->
</application>

• 对于Android 11（API 30）及以上，需要申请MANAGE_EXTERNAL_STORAGE这个特殊权限，先在AndroidManifest.xml里添加：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
    android:minSdkVersion="30" />

然后在代码里请求这个权限（注意：这个权限需要用户跳转到系统设置手动开启）：

Future<bool> getManageStoragePermission() async {
  if (await Permission.manageExternalStorage.isGranted) {
    return true;
  } else {
    final result = await Permission.manageExternalStorage.request();
    if (!result.isGranted) {
      // 引导用户去设置页开启权限
      await openAppSettings();
      return await Permission.manageExternalStorage.isGranted;
    }
    return result.isGranted;
  }
}

3. 别硬编码路径，用官方API获取正确路径 #

直接写/sdcard/不是最佳实践，应该用Flutter的path_provider包获取标准的外部存储路径：

• 先加依赖：

dependencies:
  path_provider: ^2.0.15

• 获取路径的方法：

import 'package:path_provider/path_provider.dart';

Future<String> getExternalRootPath() async {
  final externalDir = await getExternalStorageDirectory();
  return externalDir?.path ?? '';
}

4. 完整的可运行示例代码 #

import 'dart:io';
import 'package:permission_handler/permission_handler.dart';
import 'package:path_provider/path_provider.dart';

void main() async {
  bool canAccessStorage = false;

  if (Platform.isAndroid) {
    // 先检查基础存储权限
    bool hasStoragePerm = await getStoragePermissions();
    if (hasStoragePerm) {
      // Android 11+需要额外的管理权限
      if (await Permission.manageExternalStorage.isGranted) {
        canAccessStorage = true;
      } else {
        canAccessStorage = await getManageStoragePermission();
      }
    }
  } else if (Platform.isIOS) {
    // iOS端需要适配相册/文件访问权限
    canAccessStorage = await Permission.photos.isGranted;
    if (!canAccessStorage) {
      canAccessStorage = await Permission.photos.request().isGranted;
    }
    // iOS沙箱限制，无法直接遍历全目录，需要用文档选择器
  }

  if (canAccessStorage) {
    String rootPath = await getExternalRootPath();
    Directory(rootPath).list(recursive: true).listen((fileSystemEntity) {
      print(fileSystemEntity.path);
    });
  } else {
    print("未获取存储权限，无法访问目录");
  }
}

Future<bool> getStoragePermissions() async {
  final status = await Permission.storage.request();
  return status.isGranted;
}

Future<bool> getManageStoragePermission() async {
  final status = await Permission.manageExternalStorage.request();
  if (!status.isGranted) {
    await openAppSettings();
    return await Permission.manageExternalStorage.isGranted;
  }
  return status.isGranted;
}

5. iOS端的补充说明 #

iOS的沙箱机制比Android严格得多，无法直接遍历整个设备存储。如果要实现文件管理器功能，需要用file_picker或document_picker包让用户手动选择要访问的文件/目录，同时在Info.plist里添加权限描述：

<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问您的文件系统来管理文件</string>
<key>NSDocumentPickerUsageDescription</key>
<string>需要访问您的文件系统来管理文件</string>

内容的提问来源于stack exchange，提问作者Sarvesh Dalvi