Android端在用户选定文件夹创建文件遇权限问题求解决

核心原因 #

Android 10（API 29）及以上引入了Scoped Storage机制，限制应用对外部存储公共区域的直接读写权限。你尝试写入的/storage/emulated/0/TestVault属于公共根目录下的自定义文件夹，不在应用专属存储范围内，即便申请了传统的READ/WRITE_EXTERNAL_STORAGE权限，也会被系统拦截。

具体解决方案 #

1. 优先使用应用专属存储目录 #

如果配置文件可随应用卸载删除，推荐使用应用专属外部存储目录，无需额外权限（Android 10+）：

import 'package:path_provider/path_provider.dart';

// 创建配置文件到应用专属目录
Future<void> createConfigFile() async {
  final appExternalDir = await getExternalStorageDirectory();
  if (appExternalDir != null) {
    final configFile = File('${appExternalDir.path}/.witness');
    await configFile.create(recursive: true);
  }
}

2. 若需写入公共目录，适配不同Android版本 #

Android 10（API 29）

在AndroidManifest.xml的<application>标签中添加属性，临时启用旧版存储模式：

<application
    ...
    android:requestLegacyExternalStorage="true">
    ...
</application>

Android 11+（API 30及以上）

• 废弃WRITE_EXTERNAL_STORAGE权限，需申请MANAGE_EXTERNAL_STORAGE权限，该权限需引导用户到系统设置手动开启：

import 'package:permission_handler/permission_handler.dart';

// 申请管理外部存储权限
Future<void> requestManageStoragePermission() async {
  if (await Permission.manageExternalStorage.isDenied) {
    await Permission.manageExternalStorage.request();
    // 用户拒绝后引导到设置页
    if (await Permission.manageExternalStorage.isDenied) {
      openAppSettings();
    }
  }
}

• 写入文件前校验权限：

// 在用户选择的目录创建文件
Future<void> createFileInSelectedDir() async {
  final selectedDir = await FilePicker.platform.getDirectoryPath();
  if (selectedDir != null) {
    if (await Permission.manageExternalStorage.isGranted) {
      final configFile = File('$selectedDir/.witness');
      await configFile.create(recursive: true);
    } else {
      await requestManageStoragePermission();
    }
  }
}

3. 优化权限声明 #

调整AndroidManifest.xml中的权限配置，避免冗余：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<!-- 仅在Android 10及以下保留WRITE权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="29" />

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