UIDocumentPickerViewController指定directoryURL打开PDF目录真机异常求助

核心原因 #

真机上，当你以.pdf作为内容类型初始化文档选择器时，directoryURL生效的前提是你的App已经获得目标文件夹的持久化安全范围访问权限。模拟器因沙盒限制宽松，无需严格权限即可访问目录，所以功能正常；而真机上如果没有权限，文档选择器会忽略directoryURL，自动跳转到用户最后访问的目录。

当你切换到.folder类型时，文档选择器会触发系统的权限请求流程，因此能正常跳转到目标文件夹，但此时选择器仅允许选择文件夹，无法直接选取PDF文件。

解决方案 #

1. 持久化目标文件夹的访问权限 #

扫描二维码获取到目标文件夹URL后，需要将其转换为书签（Bookmark）存储，以获得持久化的访问权限：

// 处理扫描得到的folderURL
if let scannedFolderURL = scannedFolderURL {
    do {
        // 创建带安全范围的书签数据
        let bookmark = try scannedFolderURL.bookmarkData(
            options: .withSecurityScope,
            includingResourceValuesForKeys: nil,
            relativeTo: nil
        )
        // 存储书签到UserDefaults
        UserDefaults.standard.set(bookmark, forKey: "TargetFolderBookmark")
        
        // 立即获取临时访问权限
        if scannedFolderURL.startAccessingSecurityScopedResource() {
            self.folderURL = scannedFolderURL
            // 临时访问完成后记得停止，比如在App进入后台时
            defer { scannedFolderURL.stopAccessingSecurityScopedResource() }
        }
    } catch {
        print("创建书签失败：\(error.localizedDescription)")
    }
}

2. 正确初始化文档选择器并验证权限 #

在创建UIDocumentPickerViewController时，确保先获取目标文件夹的访问权限，再设置directoryURL：

struct DocumentPicker : UIViewControllerRepresentable {
    @Binding var folderURL : URL?
    @Binding var documentURL : URL?

    func makeUIViewController(context: Context) -> UIDocumentPickerViewController {
        let documentPicker = UIDocumentPickerViewController(
            forOpeningContentTypes: [.pdf], 
            asCopy: true
        )
        documentPicker.delegate = context.coordinator
        
        if let url = folderURL {
            // 确认获取访问权限
            if url.startAccessingSecurityScopedResource() {
                documentPicker.directoryURL = url
            } else {
                print("无法访问目标文件夹")
            }
        }
        return documentPicker
    }

    func updateUIViewController(_ uiViewController: UIDocumentPickerViewController, context: Context) {}
    
    // 添加Coordinator处理权限释放
    func makeCoordinator() -> Coordinator {
        Coordinator(parent: self)
    }
    
    class Coordinator: NSObject, UIDocumentPickerDelegate {
        var parent: DocumentPicker
        
        init(parent: DocumentPicker) {
            self.parent = parent
        }
        
        // 文档选择器关闭时释放权限
        func documentPickerDidDismiss(_ controller: UIDocumentPickerViewController) {
            parent.folderURL?.stopAccessingSecurityScopedResource()
        }
        
        // 处理PDF选择逻辑
        func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
            parent.documentURL = urls.first
        }
    }
}

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

在Info.plist中添加NSDocumentPickerUsageDescription键，填写权限申请说明（必须，否则真机上会崩溃或权限申请失败）：

<key>NSDocumentPickerUsageDescription</key>
<string>需要访问指定文件夹中的PDF文件以查看内容</string>

额外说明 #

• 安全范围资源的访问权限需要主动管理，记得在不需要访问时调用stopAccessingSecurityScopedResource()释放权限，避免内存泄漏。
• 如果目标文件夹URL是从二维码解析而来，确保解析后的URL是有效的file://格式，并且指向Files应用内的合法目录。

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