Swift macOS项目中PDFDocument(url:)无法创建文档求助

我来帮你搞定这个头疼的问题——你遇到的情况本质上是App沙箱权限限制在作祟！虽然你能拿到正确的文件URL，也确认文件存在，但iOS/macOS的沙箱机制会阻止App随意访问用户空间的文件，这就是为什么PDFDocument(url: pdfURL2)返回nil（也就是你说的test变量为空）。

下面给你一步步的解决方案：

1. 正确处理安全作用域资源 #

如果你是通过文件选择器（比如UIDocumentPickerViewController或NSOpenPanel）获取的文件URL，必须调用startAccessingSecurityScopedResource()来申请临时访问权限，用完后记得释放：

// 先确认URL是否是安全作用域的
if pdfURL2.startAccessingSecurityScopedResource() {
    // defer确保方法结束时一定会释放权限，避免内存泄漏
    defer { pdfURL2.stopAccessingSecurityScopedResource() }
    
    // 现在尝试加载PDF
    let test = PDFDocument(url: pdfURL2)
    if let pdfDoc = test {
        pdfView.document = pdfDoc
        print("PDF加载成功！")
    } else {
        print("PDF文档加载失败，可能是权限或文件格式问题")
    }
} else {
    print("无法获取文件访问权限，请检查App权限配置")
}

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

如果你的App需要访问特定系统目录（比如下载文件夹、文档文件夹），必须在Info.plist中添加对应的权限说明，否则系统会直接拒绝权限请求：

• 比如访问下载文件夹，添加NSDownloadsFolderUsageDescription，值填写你的App需要访问的原因（比如“需要读取用户下载的PDF文件”）；
• 访问文档文件夹则添加NSDocumentsFolderUsageDescription。

这些描述是App Store审核要求的，同时也是系统授予权限的前提。

3. 精准排查加载失败原因 #

为了更清楚知道test为nil的具体原因，可以用带错误参数的PDFDocument初始化方法：

var loadError: NSError?
let test = PDFDocument(url: pdfURL2, error: &loadError)
if let err = loadError {
    print("PDF加载错误详情：\(err.localizedDescription)")
    print("错误代码：\(err.code)")
}

通过打印的错误信息，你可以直接定位问题——比如如果是权限问题，错误信息会明确提示“无法访问文件”之类的内容。

额外小提示 #

确认你的pdfURL2是标准的file://开头的URL，而不是纯字符串路径。如果是从字符串转换来的，一定要用URL(fileURLWithPath: filePath)来创建，避免路径转URL时出现格式错误。

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