Swift中PDFView导出PDF丢失原文档链接问题排查

1. 渲染方式导致链接丢失 #

当你通过视图层级绘制（比如drawHierarchy）导出CanvasView时，本质是把所有视图渲染成位图图像写入新PDF——这种方式只会保留视觉内容，不会保留原PDF里的结构化元素（比如链接、表单字段这类可交互注释）。UILabel能保留可选文本，是因为你在导出时可能单独处理了文本的PDF属性（比如用NSAttributedString的draw(in:)生成PDF文本块），但PDFView的链接属于原PDF的注释数据，不会被位图化渲染保留。

2. 自定义导出逻辑未处理PDF注释 #

如果你的ResizablePDFView在导出时仅绘制了PDF页面的内容（比如通过PDFPage.draw(with:to:)），但没有提取原PDF页面中的注释（链接是PDFAnnotationSubtypeLink类型的注释），并将这些注释重新添加到导出的新PDF页面中，就会导致链接丢失。自定义PDFPage如果只是重绘内容、没处理注释传递，也解决不了问题。

调试方向 #

• 验证原PDF的链接是否存在：在ResizablePDFView中，打印原PDFPage的annotations数组，确认里面有PDFAnnotationSubtypeLink类型的注释：

  if let annotations = pdfView.document?.page(at: 0)?.annotations {
      for annot in annotations {
          if annot.subtype == .link {
              print("原PDF存在链接注释: \(annot)")
          }
      }
  }
  

• 检查导出时的上下文处理：确认导出PDF时，是用位图渲染还是结构化PDF内容拼接。如果用UIGraphicsBeginPDFContextToFile，检查是否只是调用了视图的draw(_:)，没有处理PDF注释的添加。
• 查看导出后的PDF结构：用预览打开导出的PDF，右键选择“检查元素”，查看是否有链接注释存在，确认是完全没有还是未正确映射位置。

解决方法 #

方案1：结构化拼接PDF内容与注释 #

导出时不要直接渲染视图，而是将原PDF页面的内容和注释，结合视图的尺寸位置变换，添加到新PDF中：

1. 创建新的PDF上下文，设置页面尺寸为CanvasView的尺寸。
2. 获取ResizablePDFView对应的原PDFPage，计算视图的变换矩阵（因为用户调整了位置和尺寸，需要把原PDF内容映射到视图的frame区域）。
3. 绘制原PDF页面到上下文（应用变换矩阵）。
4. 遍历原PDF页面的链接注释，调整注释的矩形位置（适配视图的frame和变换），将注释添加到新PDF的当前页面中。
5. 单独处理UILabel的内容，用NSAttributedString生成可选中的文本块添加到PDF上下文。

方案2：替换PDFView的导出逻辑 #

将ResizablePDFView的导出逻辑从视图渲染改为直接处理PDF文档对象：

// 示例：处理单个PDF页面的导出，保留链接
func exportPDFView(_ pdfView: PDFView, to context: CGContext, with frame: CGRect) {
    guard let page = pdfView.currentPage else { return }
    
    // 计算变换矩阵：将原PDF页面适配到视图的frame
    let pageBounds = page.bounds(for: .mediaBox)
    let scale = min(frame.width / pageBounds.width, frame.height / pageBounds.height)
    let transform = CGAffineTransform(scaleX: scale, y: scale)
        .translatedBy(x: frame.origin.x, y: frame.origin.y)
    
    // 绘制PDF页面内容
    context.saveGState()
    context.concatenate(transform)
    page.draw(with: .mediaBox, to: context)
    context.restoreGState()
    
    // 处理链接注释
    if let annotations = page.annotations {
        for annot in annotations where annot.subtype == .link {
            // 转换注释的矩形到视图坐标系
            var annotRect = annot.bounds
            annotRect = annotRect.applying(transform)
            
            // 创建新的链接注释
            let newLink = PDFAnnotation(bounds: annotRect, forType: .link, withProperties: nil)
            newLink.destination = annot.destination
            newLink.url = annot.url
            
            // 将注释添加到当前PDF页面
            if let currentPDFPage = PDFPage(context: context) {
                currentPDFPage.addAnnotation(newLink)
            }
        }
    }
}

关键注意点 #

• 必须处理视图的变换（位置、缩放），确保链接的矩形位置和原PDF内容的位置对应。
• 不要依赖视图的drawHierarchy或render(in:)这类位图渲染方法，这类方法无法保留PDF的结构化注释。

内容的提问来源于stack exchange，提问作者NKS-OB