SwiftUI中如何请求物理设备文件访问权限？解决FileImporter真机失效问题

1. 配置Info.plist权限描述 #

物理设备上无法弹出权限请求，大概率是Info.plist缺少必要的权限说明。根据你访问的文件位置，添加对应的配置：

• 访问iCloud Drive文件：添加NSUbiquitousContainers字典，配置你的iCloud容器信息（容器ID格式通常为iCloud.你的App Bundle ID），并在容器子项中设置：
  • NSUbiquitousContainerIsDocumentScopePublic：设为YES
  • NSUbiquitousContainerSupportedFolderLevels：设为Any
  • NSUbiquitousContainerName：填写你的App名称
• 访问本地设备文件（如“我的iPhone”目录）：添加NSFileProviderDomainUsageDescription键，值为权限申请的说明文本（比如“需要访问文件以导入CSV数据”），系统会基于这个文本弹出权限请求框。

2. 修正FileImporter的文件读取逻辑 #

物理设备上访问沙盒外的文件需要临时权限，处理导入结果时必须调用startAccessingSecurityScopedResource()：

FileImporter(
    isPresented: $showImporter,
    allowedContentTypes: [.commaSeparatedText],
    allowsMultipleSelection: false
) { result in
    switch result {
    case .success(let urls):
        guard let targetURL = urls.first else { return }
        // 申请临时访问权限
        guard targetURL.startAccessingSecurityScopedResource() else {
            // 权限申请失败，提示用户
            return
        }
        defer {
            // 用完后释放权限
            targetURL.stopAccessingSecurityScopedResource()
        }
        // 读取CSV内容
        do {
            let csvContent = try String(contentsOf: targetURL)
            // 处理CSV数据
        } catch {
            // 捕获读取错误
        }
    case .failure(let error):
        // 处理导入失败情况
    }
}

同时确认allowedContentTypes使用正确的UTI，CSV对应的标准UTI是public.comma-separated-values-text，用.commaSeparatedText枚举即可。

3. 检查Xcode项目能力配置 #

进入项目的Signing & Capabilities页面：

• 如果需要访问iCloud Drive，确保添加了iCloud能力，并勾选iCloud Documents选项
• 确认App Sandbox的File Access中，User Selected File权限设置为Read Only或Read/Write（默认FileImporter会自动适配，但建议手动确认）

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