使用PDFKit作为PDFViewer时遭遇滚动异常（Kotlin MultiPlatform）

问题分析 #

当前代码中PDFView无法正常滚动，但双击底部能跳转页面，大概率是布局约束未正确配置或缩放比例设置时机错误导致滚动区域计算异常，也可能和Compose嵌入原生视图时的交互冲突有关。

修复步骤 #

1. 配置正确的Auto Layout约束 #

原生UIView默认启用translatesAutoresizingMaskIntoConstraints，会和Compose的布局系统冲突，导致PDFView的可滚动区域无法正确计算。需要禁用该属性：

pdfView.translatesAutoresizingMaskIntoConstraints = false

2. 调整缩放比例的设置时机 #

原代码在PDF文档加载前就设置了scaleFactor = 1.5，可能导致布局初始化异常。建议在文档加载完成后再设置缩放比例：

if let filePath, let document = PDFDocument(url: filePath) {
  pdfView.document = document
  // 可选：使用适配尺寸的缩放比例，或保持自定义值
  pdfView.scaleFactor = pdfView.scaleFactorForSizeToFit
  // pdfView.scaleFactor = 1.5 // 若需要固定缩放比例，移到此处设置
}

3. 确认Compose端的嵌入配置 #

在KMP的Compose代码中，嵌入原生PDFView时必须设置Modifier.fillMaxSize()，确保视图占据正确的布局空间：

// iOS模块的Compose代码示例
UIKitView(
    factory = { IOSNativeViewFactory().createPdfView(path = "your_pdf_file.pdf") },
    modifier = Modifier.fillMaxSize()
)

4. 排查手势冲突（可选） #

如果以上步骤无效，检查是否有父视图的手势识别器拦截了PDFView的滚动事件。可以尝试给UIKitView添加空的指针输入处理，避免Compose拦截触摸事件：

UIKitView(
    factory = { IOSNativeViewFactory().createPdfView(path = "your_pdf_file.pdf") },
    modifier = Modifier.fillMaxSize().pointerInput(Unit) {}
)

修改后的完整代码 #

import UIKit
import PDFKit
import composeApp

class IOSNativeViewFactory: NativeViewFactory {
  func createPdfView(path: String) -> UIView {
    let filePath = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)
      .first?.appendingPathComponent(path)
    let pdfView = PDFView()
    
    // 禁用自动调整mask，适配Compose布局
    pdfView.translatesAutoresizingMaskIntoConstraints = false
    pdfView.autoScales = true
    pdfView.displayMode = .singlePageContinuous
    pdfView.displayDirection = .vertical
    pdfView.minScaleFactor = 1.0
    pdfView.maxScaleFactor = 4.0
    
    if let filePath, let document = PDFDocument(url: filePath) {
      pdfView.document = document
      // 文档加载完成后设置缩放比例
      pdfView.scaleFactor = pdfView.scaleFactorForSizeToFit
    }
    return pdfView
  }
}

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