SwiftUI用.fileImporter取本地PDF后初始化PDFDocument返回nil如何解决

核心原因 #

该问题由iOS沙盒权限机制导致，和路径中的private前缀无关。系统通过.fileImporter返回的URL属于安全作用域资源，App默认没有直接读取权限，必须显式申请临时访问权限后才能读取文件内容。

修正后代码 #

import PDFKit
// ... 其余视图代码
.fileImporter(isPresented: $isPresented, allowedContentTypes: [.pdf]) { result in
    switch result {
    case .success(let url):
        // 申请安全作用域访问权限
        guard url.startAccessingSecurityScopedResource() else {
            print("无法获取文件访问权限")
            return
        }
        // 保证权限一定会被释放
        defer {
            url.stopAccessingSecurityScopedResource()
        }
        // 现在可以正常读取文件
        if let pDFDocument = PDFDocument(url: url) {
            if let data = pDFDocument.dataRepresentation() {
                // 执行存储data的逻辑
            }
        } else {
            // 可选：如果不需要操作PDF结构，可直接读取Data
            do {
                let data = try Data(contentsOf: url)
                // 执行存储data的逻辑
            } catch {
                print("读取文件失败：\(error)")
            }
        }
    case .failure(let error):
        print("文件选择失败：\(error)")
    }
}

注意事项 #

• 权限申请url.startAccessingSecurityScopedResource()返回false的常见场景包括：文件处于iCloud未完成下载、文件被系统加密、路径无效等
• 必须通过defer配对调用stopAccessingSecurityScopedResource()，否则会造成系统资源泄漏，触发沙盒运行警告
• 若需要长期访问该文件，不可直接持久化当前URL，需要生成安全书签存储，下次启动后通过书签还原URL并重新申请访问权限
• 若导入的是iCloud云盘文件，可通过FileManager.default.isUbiquitousItem(at: url)判断文件归属，未下载的文件需要先触发iCloud同步才能读取

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