Flutter安卓端创建外部存储目录报Operation not permitted错误如何解决

错误原因 #

• 权限动态申请缺失：WRITE_EXTERNAL_STORAGE属于Android危险权限，仅在AndroidManifest中静态声明无效，需要在Flutter业务代码中主动向用户发起授权申请，用户同意后才能获得存储操作权限
• 高版本安卓系统适配问题：android:requestLegacyExternalStorage="true"仅对Android 10（API 29）设备生效，若App的targetSdkVersion >=30（对应Android 11及以上系统），该配置会被系统忽略，默认强制执行分区存储规则，不允许直接修改公共目录下的自定义文件夹
• 路径格式错误：你使用的路径storage/emulated/0/myDir缺少根路径前缀/，不属于合法的绝对路径，系统会识别为相对路径导致创建失败

修复方案 #

1. 修正AndroidManifest配置 #

如果你的应用targetSdkVersion >=30，需要新增管理外部存储权限声明，完整配置参考如下：

<!-- Android 11+ 管理所有文件权限 -->
<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<!-- 低版本读写存储权限，maxSdkVersion设置为29避免高版本冗余申请 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_MEDIA_LOCATION"/>

<application
    android:requestLegacyExternalStorage="true"
    <!-- 保留原有application其他配置 -->
>

注意：如果你的应用需要上架Google Play，使用MANAGE_EXTERNAL_STORAGE权限需要向Google提交使用场景说明，符合政策要求才能过审，否则优先使用下文提到的App私有目录存储方案。

2. 动态申请存储权限 #

使用permission_handler依赖包在Dart代码中主动发起权限申请，示例代码如下：

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

// 统一申请存储权限
Future<bool> requestStoragePermission() async {
  if (!Platform.isAndroid) return true;
  final androidInfo = await DeviceInfoPlugin().androidInfo;
  final sdkInt = androidInfo.version.sdkInt;
  // Android 11及以上申请管理所有文件权限
  if (sdkInt >= 30) {
    final managePermission = Permission.manageExternalStorage;
    final status = await managePermission.request();
    if (status.isDenied) {
      // 权限被拒绝可跳转应用设置页引导用户手动开启
      await openAppSettings();
      return false;
    }
    return status.isGranted;
  } 
  // Android 10及以下申请读写存储权限
  else {
    final storagePermission = Permission.storage;
    final status = await storagePermission.request();
    if (status.isDenied) {
      await openAppSettings();
      return false;
    }
    return status.isGranted;
  }
}

// 创建文件夹逻辑，先判断权限再操作
void createCustomDir() async {
  bool hasPermission = await requestStoragePermission();
  if (hasPermission) {
    // 修正路径，添加根路径前缀/
    final targetDir = Directory('/storage/emulated/0/myDir');
    if (!await targetDir.exists()) {
      await targetDir.create(recursive: true);
    }
  }
}

3. 最优替代方案（无需申请权限） #

如果你的应用不需要在公共目录存放用户可见的独立文件，优先使用App私有目录存储，不需要申请任何存储权限，可通过path_provider依赖包获取路径：

import 'package:path_provider/path_provider.dart';

Future<Directory> getAppPrivateDir() async {
  // 获取App外部私有目录，卸载应用时会同步删除
  final appExternalDir = await getExternalStorageDirectory();
  final myDir = Directory('${appExternalDir!.path}/myDir');
  if (!await myDir.exists()) {
    await myDir.create(recursive: true);
  }
  return myDir;
}

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