Flutter通过path_provider创建的文件夹在Android12文件管理器无法找到

问题现象 #

在Android 12设备上，使用path_provider创建文件夹后，通过.exists()方法可确认文件夹真实存在，但系统文件管理器中始终搜索、浏览不到对应目录。

问题复现代码 #

Future<String> getFilePath() async {
  Directory endPointDirectory=Directory("");
  const String folderName="cameraFlutter";// 用于存储文件的目标文件夹
  var directory=getExternalStorageDirectory()
      .then((value) async {
    final Directory endPointDirectory=Directory("${value!.path}/$folderName");
    if (await endPointDirectory.exists()) {
      print("exist");
      print(endPointDirectory.path);

    } else {
    // 文件夹不存在时先创建再返回路径
      print("not exist");
      await endPointDirectory.create();

    }

  }).catchError((onError){
    print(onError.toString());

  });
  return endPointDirectory.path;// 外部存储目录
}

相关运行参考截图：

问题原因 #

• 代码本身存在逻辑缺陷：then回调内重新声明了同名局部变量endPointDirectory，方法外层返回的始终是初始化时的空路径Directory对象，根本没有返回实际创建的目录路径，但该问题不影响文件夹实际创建逻辑。
• 核心原因是目录访问权限限制：getExternalStorageDirectory()在Android平台返回的是应用专属外部存储目录，路径格式通常为/storage/emulated/0/Android/data/<应用包名>/files/。从Android 11开始强制启用分区存储机制，普通文件管理器（包括系统自带文件管理器）默认没有权限访问Android/data路径下的应用私有目录内容，因此看不到你创建的文件夹，并非文件夹创建失败。

解决方案 #

1. 先修复现有代码的逻辑错误，避免局部变量遮蔽，正确返回目标目录路径，修复后代码如下：

Future<String> getFilePath() async {
  const String folderName = "cameraFlutter";
  try {
    final Directory? appExternalDir = await getExternalStorageDirectory();
    if (appExternalDir == null) {
      throw Exception("获取外部存储目录失败");
    }
    final Directory targetDir = Directory("${appExternalDir.path}/$folderName");
    // 加recursive: true支持多级目录自动创建
    if (!await targetDir.exists()) {
      await targetDir.create(recursive: true);
    }
    print("目标文件夹路径：${targetDir.path}");
    return targetDir.path;
  } catch (err) {
    print("目录操作报错：$err");
    rethrow;
  }
}

2. 如果需要创建的文件夹能被系统文件管理器、其他应用正常识别浏览，不要将文件夹存放在应用专属私有目录：
   • 存储公共媒体/下载文件时，优先使用getExternalStoragePublicDirectory()获取系统公共目录（如DCIM、Download、Documents等），Android 10及以上版本建议配合MediaStore API完成文件写入，不需要额外申请敏感权限。
   • 确需在存储根目录创建自定义文件夹的，需要在AndroidManifest.xml中声明MANAGE_EXTERNAL_STORAGE权限，引导用户跳转设置页授予所有文件访问权限，该权限属于高危权限，上架Google Play时会有严格的审核限制，非必要场景不建议使用。

验证方法：将日志打印的完整目录路径，在已授予所有文件访问权限的文件管理器中手动输入路径跳转，即可看到已创建的cameraFlutter文件夹，确认目录真实存在。

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