SwiftUI用UIViewRepresentable封装PDFView触发AttributeGraph循环警告如何解决

问题根因 #

该警告并非代码存在手动书写的内存循环，而是PDFKit内部布局逻辑和SwiftUI的AttributeGraph状态管理机制冲突导致：原有实现每次触发updateUIView都会无条件重新创建PDFDocument并赋值，频繁的属性变更会触发PDFView内部的布局重绘，和SwiftUI的布局校验逻辑形成交叉依赖，进而触发循环警告。另外外部强制解包Binding、无意义的View刷新也会放大该问题。

修复方案 #

1. 优化MyPDFView实现 #

import PDFKit
import SwiftUI

struct MyPDFView: UIViewRepresentable {
    typealias UIViewType = PDFView
    // 仅展示场景无需Binding，改为普通属性即可，需要双向修改时再改回@Binding
    let pdf: Data?

    func makeUIView(context: Context) -> PDFView {
        let pdfView = PDFView()
        // 所有固定配置统一在初始化时设置，避免后续修改触发不必要的布局更新
        pdfView.autoScales = true
        pdfView.displayMode = .singlePageContinuous
        pdfView.displaysPageBreaks = true
        pdfView.translatesAutoresizingMaskIntoConstraints = false
        return pdfView
    }

    func updateUIView(_ pdfView: PDFView, context: Context) {
        // 仅当PDF数据发生实际变化时才更新文档，避免重复赋值
        guard let pdf = pdf,
              pdfView.document?.dataRepresentation() != pdf else {
            return
        }
        pdfView.document = PDFDocument(data: pdf)
    }
}

// 支持equatable对比，方便SwiftUI判断是否需要刷新
extension MyPDFView: Equatable {
    static func == (lhs: Self, rhs: Self) -> Bool {
        lhs.pdf == rhs.pdf
    }
}

2. 优化调用逻辑 #

// 原有数据结构保持不变
struct PDFStruct {
    var pdf: Data?
}

// 调用侧代码
@Binding var pdfStruct: PDFStruct
var body: some View {
    MyPDFView(pdf: pdfStruct.pdf)
        // 仅当PDF数据变化时才刷新整个MyPDFView，跳过无意义的重绘
        .equatable()
        // 固定布局尺寸，避免PDFView自适应大小触发的布局循环
        .frame(maxWidth: .infinity, maxHeight: .infinity)
}

补充说明 #

如果是iOS 15及以下系统仍有少量警告，属于PDFKit内部已知问题，不影响实际功能使用，也不会造成内存泄漏；如果需要完全消除，可以在makeUIView中添加pdfView.setValue(false, forKey: "enablePageShadows")（私有API，使用时注意风险）。

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