Flutter开发Android 12应用无法获取内置存储文件问题

问题背景 #

在Android 12系统上开发Flutter应用时，出现以下异常情况：

• 已在AndroidManifest.xml中声明READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE、MANAGE_EXTERNAL_STORAGE权限，且应用已获得用户授权
• 能够读取内置存储的目录结构，但无法获取txt、md、PDF格式的文件
• 使用代码Directory('/storage/emulated/0/docs').listSync(recursive: true)获取文件列表

核心原因及解决步骤 #

1. 确认MANAGE_EXTERNAL_STORAGE权限的实际授权状态 #

Android 12+中，MANAGE_EXTERNAL_STORAGE权限无法通过常规权限请求弹窗自动获取，必须引导用户到应用设置页面手动开启**"所有文件访问权限"**。

可以通过permission_handler插件实现权限检查与跳转：

import 'package:permission_handler/permission_handler.dart';
import 'package:url_launcher/url_launcher.dart';

Future<void> verifyManageStoragePermission() async {
  final status = await Permission.manageExternalStorage.status;

  if (status.isDenied) {
    await Permission.manageExternalStorage.request();
  }

  if (status.isPermanentlyDenied) {
    // 跳转到应用设置页面让用户手动开启权限
    await launchUrl(Uri.parse('app-settings:'));
  }
}

注意：requestLegacyExternalStorage属性仅对Android 10-11的暂存访问有效，Android 12+中该属性不影响MANAGE_EXTERNAL_STORAGE权限的生效。

2. 排查文件过滤逻辑 #

确保listSync调用未隐含过滤规则，若需筛选特定格式文件，需显式处理（若未过滤则跳过此步）：

import 'package:path/path.dart' as path;

// 获取目录下所有txt/md/PDF文件
final dir = Directory('/storage/emulated/0/docs');
final targetFiles = dir.listSync(recursive: true)
    .where((entity) => 
        entity is File && 
        ['.txt', '.md', '.pdf'].contains(path.extension(entity.path).toLowerCase()))
    .toList();

3. 验证文件路径与存在性 #

• 确认/storage/emulated/0/docs目录下确实存在目标文件，可通过系统文件管理器核实
• 打印所有读取到的实体路径，排查是否文件被遗漏：

final entities = dir.listSync(recursive: true);
for (var entity in entities) {
  print('已读取实体：${entity.path}');
}

4. 合规性替代方案（推荐） #

若应用并非文件管理器类工具，建议避免使用MANAGE_EXTERNAL_STORAGE权限（该权限需符合Google Play政策审核要求），转而使用Android推荐的MediaStore或**存储访问框架(SAF)**来访问特定文件，这是Scoped Storage下的标准做法。

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