iOS中使用Alamofire下载PDF后无法在PDFView中显示问题

这种情况确实挺闹心的——明明确认文件已经成功下载到Documents目录了，PDFView却只显示空白，但用Bundle里的本地PDF又能正常展示，说明PDFView本身是没问题的，问题大概率出在下载文件的处理或者路径权限上。下面给你梳理几个排查方向和解决办法：

1. 先确认下载的PDF文件是否完整/未损坏 #

有时候网络不稳定会导致下载的文件不完整，表面上看文件大小对得上，但实际内容是残缺的。你可以通过Xcode的「Devices and Simulators」找到你的App容器，把Documents目录里的PDF导出来，手动用PDF阅读器打开看看能不能正常显示。如果打不开，那就是下载过程出问题了，得检查你的下载代码（比如NSURLSession的回调里，是不是把接收到的数据完整写入文件了，有没有遗漏分块下载的情况）。

2. 核对文件URL的正确性 #

确保你拼接Documents目录路径的代码没有问题，比如：

let documentsDir = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first!
let targetPDFURL = documentsDir.appendingPathComponent("你的文件名.pdf")

可以打印targetPDFURL.path看看路径是否符合预期，有没有文件名拼写错误（比如大小写不一致、后缀写成了.pdf以外的格式）。

3. 检查文件的可读取性 #

虽然Documents目录默认是可读写的，但偶尔会出现写入时权限异常的情况。你可以加一段代码验证文件状态：

if FileManager.default.fileExists(atPath: targetPDFURL.path) {
    do {
        let fileAttrs = try FileManager.default.attributesOfItem(atPath: targetPDFURL.path)
        let fileSize = fileAttrs[.size] as? Int64 ?? 0
        print("下载文件大小：\(fileSize) bytes")
        // 对比服务器上的1.1Mb（约1126400 bytes），如果差距很大说明下载不完整
    } catch {
        print("读取文件属性失败：\(error.localizedDescription)")
    }
} else {
    print("文件不存在！路径可能有误")
}

4. 确保PDFDocument初始化正确且带错误处理 #

直接用PDFDocument(url:)初始化可能会静默失败，最好加上守卫语句捕获问题：

guard let pdfDoc = PDFDocument(url: targetPDFURL) else {
    print("无法初始化PDFDocument，可能文件损坏或路径错误")
    return
}
pdfView.document = pdfDoc
// 记得开启自动缩放，避免内容超出视图范围
pdfView.autoScales = true

5. 确认UI更新在主线程执行 #

如果你的下载操作是在后台线程完成的，更新PDFView的代码一定要切回主线程，否则可能导致UI不刷新：

// 假设下载完成的回调在后台线程
DispatchQueue.main.async {
    guard let pdfDoc = PDFDocument(url: targetPDFURL) else {
        print("初始化PDF失败")
        return
    }
    self.pdfView.document = pdfDoc
    self.pdfView.autoScales = true
}

按照上面的步骤逐一排查，应该能找到问题所在。

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