Flutter iOS真机保存文件时抛出PathAccessException问题求助

iOS 端配置 #

权限声明 #

iOS真机触发PathAccessException的核心原因是缺少权限描述声明，需在Info.plist中添加以下配置：

• 添加NSDocumentDirectoryUsageDescription：填写App需要访问目录的原因，例如"需要将PDF文件保存到您选择的目录"
• 若需支持iCloud云盘目录，额外添加NSUbiquitousContainersUsageDescription，说明使用iCloud的用途

额外注意 #

• iOS 13及以上版本中，通过file_picker的getDirectoryPath获取的目录，App默认拥有读写权限，但必须在Info.plist中声明对应的使用描述，否则真机将触发权限异常
• 不要尝试直接访问系统级受保护目录（如根目录、系统核心文件夹），仅操作用户通过文件选择器选中的合法目录

Android 端配置 #

权限声明 #

在AndroidManifest.xml中添加对应权限：

• 适配Android 10及以下版本的基础读写权限：

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
  

• 适配Android 10+的全文件访问权限（仅当需要访问所有公共目录时使用，普通场景不推荐）：

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

适配建议 #

• Android 10+推荐使用Scoped Storage机制，通过file_picker获取的目录，App自动拥有该目录的读写权限，无需额外申请普通读写权限
• 系统受保护目录（如其他App私有目录、系统核心目录）本身属于Android安全限制范畴，无法正常操作，需引导用户选择可访问的目录（如下载、文档目录）

通用代码校验 #

保存文件前可提前校验目录的可访问性，避免抛出异常：

import 'dart:io';

Future<bool> checkDirectoryValidity(String path) async {
  final dir = Directory(path);
  if (await dir.exists()) {
    return await dir.canWrite();
  }
  return false;
}

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