iOS端Flutter应用文件下载遇PathAccessException：权限及解决

一、iOS权限配置要求 #

iOS沙箱机制对文件访问有严格限制，即使通过FilePicker选中目录，也必须在Info.plist中添加权限用途描述：

• 打开项目的ios/Runner/Info.plist，添加以下键值对：

  <key>NSDocumentFolderUsageDescription</key>
  <string>需要访问文档目录以保存您下载的文件</string>
  

  描述内容可根据应用场景自定义，必须明确告知用户权限用途，否则会被系统拒绝访问。
• 若需访问iCloud云盘，额外添加NSUbiquitousContainers配置即可，常规本地目录保存仅需上述描述。

二、代码逻辑优化 #

直接使用File.writeAsBytes在iOS上可能因沙箱路径安全限制失败，推荐两种修改方式：

方式1：适配沙箱路径的写入逻辑 #

final String? selectedDirectory = await FilePicker.platform.getDirectoryPath();
if (selectedDirectory != null) {
  final String filePath = '$selectedDirectory/${fileName}${ext}';
  final File file = File(filePath);
  
  try {
    // 递归创建目录（若不存在）
    await file.create(recursive: true);
    await file.writeAsBytes(fileData);
  } on PathAccessException catch (e) {
    print('文件写入失败：${e.message}');
    // 此处可添加弹窗提示用户检查权限或更换保存位置
  }
}

方式2：使用FilePicker原生保存方法（推荐） #

FilePicker提供的saveFile方法直接调用系统原生保存对话框，自动处理iOS权限与路径问题，无需手动编写写入逻辑：

final String? savedFilePath = await FilePicker.platform.saveFile(
  dialogTitle: '选择保存位置',
  fileName: '$fileName$ext',
  bytes: fileData,
);

if (savedFilePath != null) {
  print('文件已保存至：$savedFilePath');
}

该方式完全符合iOS人机交互规范，不会触发路径访问异常，是最稳妥的实现方案。

三、替代方案 #

若上述方法仍存在问题，可尝试以下替代方案：

• 系统分享功能：使用share_plus包将文件数据分享给用户，由用户通过系统应用（如「文件」App）自行选择保存位置。
• 沙箱目录中转：用path_provider获取应用文档目录保存文件，引导用户通过iOS「文件」App找到该目录，手动将文件移动至自选位置。

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