iOS下PDFKit加载PDF报错：failed to find PDF header: `%PDF' not found 求解决

我之前也碰到过类似的偶发问题，结合自己的排查经验和社区讨论，给你几个可行的解决方向：

1. 先确认下载的文件是否真的是有效PDF #

Alamofire的download方法返回.success只代表文件下载完成，但不保证内容是正确的PDF——比如服务器可能返回了错误页面（404/500）、重定向后的非PDF内容，或者网络中断导致文件不完整。

建议在回调里先验证文件的头部标识，这是最直接的排查手段：

Alamofire.download(urlrequest!, to: destination).responseData { (response) in
    switch response.result {
    case .success(let data):
        // 检查PDF头部是否存在
        let expectedHeader = "%PDF-"
        if let actualHeader = String(data: data.prefix(expectedHeader.count), encoding: .ascii), 
           actualHeader == expectedHeader {
            completion(response.destinationURL)
        } else {
            print("下载的文件不是有效PDF，可能是服务器返回错误内容")
            // 这里可以处理错误，比如给用户提示
        }
    case .failure(let err):
        print("下载失败: \(err.localizedDescription)")
    }
}

2. 确保请求头正确，引导服务器返回PDF内容 #

有些服务器会根据请求的Accept头返回不同格式的内容，如果你没有明确指定，可能拿到的不是PDF文件。给你的urlrequest添加Accept头试试：

urlrequest?.setValue("application/pdf", forHTTPHeaderField: "Accept")

3. 针对Apple系统版本的兼容处理 #

你提到的Apple Bug确实存在过，主要集中在iOS 14.x的部分小版本里，PDFKit解析本地URL时偶发头部检测失败。目前后续的iOS更新（iOS 15及以上）已经修复了大部分这类问题，建议：

• 把App的部署目标至少设置为iOS 15+
• 如果需要兼容旧版本，不要直接用PDFDocument(url:)初始化，改成先读取文件Data再初始化：

// 替代原来的PDFDocument(url: fileURL)
do {
    let pdfData = try Data(contentsOf: fileURL)
    guard let pdfDoc = PDFDocument(data: pdfData) else {
        print("无法解析PDF文件")
        return
    }
    // 正常处理PDF文档
} catch let err {
    print("读取PDF文件失败: \(err.localizedDescription)")
}

4. 检查文件写入完整性 #

极端情况下（比如磁盘空间不足、App后台被中断），文件可能没有完全写入磁盘。可以在回调里检查文件大小是否合理，或者如果服务器提供了文件哈希值（比如MD5），可以本地计算后比对，确保文件完整。

内容的提问来源于stack exchange，提问作者Marlon Brando aka Ben