如何为PDFView设置PDFPageOverlayViewProvider？设置后方法未调用

问题现象 #

为PDFView配置pageOverlayViewProvider后，PDFPageOverlayViewProvider协议的相关方法（如pdfView(_:overlayViewFor:)）完全没有触发，但PDFViewDelegate的方法可以正常执行。

核心原因分析 #

你的代码中调用了pdfView.usePageViewController(true)，这是关键问题所在：当PDFView启用PageViewController模式时，系统会使用UIPageViewController管理页面切换，这种模式下**pageOverlayViewProvider机制不会生效**，因为PageViewController的页面渲染逻辑和原生PDFView的单页/连续模式完全不同。

修复方案 #

方案1：关闭PageViewController模式 #

直接移除pdfView.usePageViewController(true)这一行代码，让PDFView使用原生的连续滚动模式，此时pageOverlayViewProvider的方法会正常被调用：

func makeUIView(context: Context) -> PDFView {
    let pdfView = PDFView()
    
    pdfView.document = document
    pdfView.displayMode = .singlePageContinuous
    pdfView.displayDirection = .vertical
    pdfView.autoScales = true
    pdfView.delegate = context.coordinator
    pdfView.pageOverlayViewProvider = context.coordinator
    // 移除这一行：pdfView.usePageViewController(true)
    pdfView.backgroundColor = .clear
    
    document.delegate = context.coordinator

    return pdfView
}

方案2：在PageViewController模式下自定义Overlay #

如果必须保留PageViewController模式，可以通过以下方式实现类似的overlay效果：

• 监听PDFView的页面切换事件（通过PDFViewDelegate的pdfViewDidChangePage(_:)方法）
• 手动为当前显示的PDFPage添加自定义UIView作为子视图
• 注意处理页面缩放、滚动时的布局更新

额外检查点 #

1. 协议方法签名正确性：确保PDFPageOverlayViewProvider的方法参数和返回值完全匹配官方定义，比如pdfView(_:overlayViewFor:)必须返回UIView?，参数类型不能写错。
2. 代理对象生命周期：确认Coordinator对象没有被提前释放，在UIViewRepresentable中，Coordinator会和View绑定，只要View存在就不会被释放，这一点你的代码是符合要求的。

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