如何访问Files应用选中的文件夹内容？权限错误257求助

问题根源 #

你直接拼接文件系统路径生成子文件URL的方式错误：通过UIDocumentPicker获取的文件夹URL是安全范围URL，权限仅绑定该URL本身，不能将其转换为路径后再拼接生成子文件路径（这样得到的URL不具备安全范围权限），所以调用startAccessingSecurityScopedResource会返回false，进而触发257权限错误。

正确操作流程 #

1. 处理文件夹选择结果 #

选中文件夹后，直接基于该URL生成子文件URL，不要转换为路径：

// 假设selectedFolderURL是从UIDocumentPicker获取的文件夹URL
guard selectedFolderURL.startAccessingSecurityScopedResource() else {
    print("无法获取文件夹安全范围权限")
    return
}

// 正确生成子文件URL
let fileListURL = selectedFolderURL.appendingPathComponent("fileList.json")

// 执行下载操作
do {
    try FileManager.default.startDownloadingUbiquitousItem(at: fileListURL)
} catch {
    print("下载失败：\(error.localizedDescription)")
}

// 操作完成后释放权限
selectedFolderURL.stopAccessingSecurityScopedResource()

2. 持久化文件夹权限（重启应用后仍可访问） #

如果需要在重启应用后继续访问该文件夹，需将URL转换为bookmark数据存储：

// 保存bookmark
do {
    let bookmarkData = try selectedFolderURL.bookmarkData(
        options: .withSecurityScope,
        includingResourceValuesForKeys: nil,
        relativeTo: nil
    )
    UserDefaults.standard.set(bookmarkData, forKey: "SelectediCloudFolder")
} catch {
    print("保存bookmark失败：\(error)")
}

// 恢复URL
if let bookmarkData = UserDefaults.standard.data(forKey: "SelectediCloudFolder") {
    var isStale = false
    do {
        let restoredURL = try URL(
            resolvingBookmarkData: bookmarkData,
            options: .withSecurityScope,
            relativeTo: nil,
            bookmarkDataIsStale: &isStale
        )
        if restoredURL.startAccessingSecurityScopedResource() {
            // 保存restoredURL用于后续操作
            if isStale {
                // 如果bookmark已过期，重新生成并保存
                let newBookmarkData = try restoredURL.bookmarkData(
                    options: .withSecurityScope,
                    includingResourceValuesForKeys: nil,
                    relativeTo: nil
                )
                UserDefaults.standard.set(newBookmarkData, forKey: "SelectediCloudFolder")
            }
        }
    } catch {
        print("恢复URL失败：\(error)")
    }
}

3. Info.plist必要配置 #

确保添加以下配置，才能正常访问iCloud Drive：

<!-- iCloud容器配置 -->
<key>NSUbiquitousContainers</key>
<dict>
    <key>iCloud.你的应用BundleID</key>
    <dict>
        <key>NSUbiquitousContainerIsDocumentScopePublic</key>
        <true/>
        <key>NSUbiquitousContainerSupportedFolderLevels</key>
        <string>Any</string>
        <key>NSUbiquitousContainerName</key>
        <string>你的应用名称</string>
    </dict>
</dict>

<!-- 允许文件共享 -->
<key>UIFileSharingEnabled</key>
<true/>

<!-- 支持直接在iCloud Drive中访问文件 -->
<key>LSSupportsOpeningDocumentsInPlace</key>
<true/>

类似Logseq的应用实现逻辑 #

这类应用之所以能通过选择根文件夹访问所有子文件，核心是严格遵循以下规范：

• 全程使用安全范围URL操作，从不直接使用文件系统路径
• 通过appendingPathComponent/appendingPathExtension等URL API生成子文件/子文件夹URL
• 持久化文件夹的bookmark数据，确保重启应用后仍能获取安全范围权限
• 每次访问资源前调用startAccessingSecurityScopedResource，操作完成后调用stopAccessingSecurityScopedResource释放权限

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