iOS实机使用PDFKit缩放PDF时内存峰值过高崩溃问题咨询

架构老林

2026-9-28

问题原因

缩放实现方式错误：你没有使用PDFView原生的矢量缩放能力，而是通过修改容器视图的CGAffineTransform实现缩放。系统对应用transform的视图会自动生成栅格化位图缓存，真机的缓存回收策略比模拟器宽松很多，反复缩放过程中旧的高分辨率位图缓存无法及时释放，导致内存持续上涨。PDF为矢量格式，缩放比例越高，生成的位图尺寸越大，比如将400*500的视图放大10倍，单张缓存位图就会占用近80MB内存，多次缩放后缓存堆积自然会涨到2-3GB触发崩溃。模拟器使用电脑的内存资源，缓存阈值高、回收快，所以不会出现内存暴涨问题。
CustomPDFView的错误限制：你在CustomPDFView中锁定了minScaleFactor和maxScaleFactor，直接禁用了PDFView原生的矢量缩放优化，原生PDFView缩放时会实时重绘矢量内容，不会生成超大缓存位图，绕开原生缩放的方案本身就会带来性能和内存问题。
捏合手势逻辑错误：你的手势处理代码没有在每次应用transform后重置gesture.scale，导致scale值会持续累积，视图被无限制放大，位图缓存的尺寸也会越来越大，加速内存上涨。

解决方案

优先使用PDFView原生缩放：删除自定义的捏合手势，移除CustomPDFView中锁缩放的逻辑，直接使用PDFView自带的缩放能力，原生实现会自动优化矢量渲染，不会产生大量缓存，内存可以稳定在模拟器测试的水平。
示例修改后的核心代码：

// 移除CustomPDFView的缩放锁，或者直接使用原生PDFView
class CustomPDFView: PDFView {}

class ViewController: UIViewController {
    var containerView: UIView = UIView()
    var pdfView: CustomPDFView = CustomPDFView()

    override func viewDidLoad() {
        super.viewDidLoad()
        self.view.addSubview(containerView)
        containerView.frame = self.view.frame.insetBy(dx: 100, dy: 100)
        containerView.backgroundColor = .black
        loadPDF()
    }

    func loadPDF() {
        containerView.addSubview(pdfView)
        pdfView.frame = containerView.bounds
        pdfView.autoresizingMask = [.flexibleWidth, .flexibleHeight]
        pdfView.displayDirection = .vertical
        pdfView.autoScales = true
        pdfView.displayMode = .singlePage
        pdfView.displaysPageBreaks = false
        pdfView.pageShadowsEnabled = false
        // 配置合理的缩放范围
        pdfView.minScaleFactor = pdfView.scaleFactorForSizeToFit
        pdfView.maxScaleFactor = 5.0
        let pdfURL = Bundle.main.url(forResource: "A100page47", withExtension: "pdf")
        pdfView.document = PDFDocument(url: pdfURL!)
    }
}

若必须保留容器缩放逻辑：在手势处理中每次应用transform后重置gesture.scale为1，避免scale无限累积，同时在手势结束、取消状态下手动触发PDFView重绘，清理临时缓存：

@objc func pinchHandler(_ gesture: UIPinchGestureRecognizer) {
    guard let view = gesture.view else { return }
    let currentTransform = view.transform.scaledBy(x: gesture.scale, y: gesture.scale)
    view.transform = currentTransform
    // 重置scale避免累积
    gesture.scale = 1
    // 手势结束时清理缓存
    if gesture.state == .ended || gesture.state == .cancelled {
        pdfView.setNeedsDisplay()
    }
}

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