SwiftUI渲染视图为PDF：点击ShareLink出现调试错误（功能正常无崩溃）

问题描述 #

通过代码将SwiftUI视图渲染为PDF后，功能正常且应用不崩溃，但点击ShareLink按钮时，调试区域会出现文件权限类错误（提示“无法打开文件，因为你没有查看权限”）。

我的代码 #

struct ContentView: View {
    
    var body: some View { ...
        // Rest of the codes
        
            }
        }
        .navigationTitle("")
        .navigationBarTitleDisplayMode(.inline)
        .toolbar {
            ToolbarItemGroup {
                ShareLink("Export PDF", item: render())
            }
        }
    }
    
    func render() -> URL {
        // 1: Render Hello World with some modifiers
        let renderer = ImageRenderer(content: PdfView)
        
        
        // 2: Save it to our documents directory
        let url = URL.documentsDirectory.appending(path: "test.pdf")
        
        // 3: Start the rendering process
        renderer.render { size, context in
            // 4: Tell SwiftUI our PDF should be the same size as the views we're rendering
            var box = CGRect(x: 0, y: 0, width: size.width, height: size.height)
            
            // 5: Create the CGContext for our PDF pages
            guard let pdf = CGContext(url as CFURL, mediaBox: &box, nil) else {
                return
            }
            
            // 6: Start a new PDF page
            pdf.beginPDFPage(nil)
            
            // 7: Render the SwiftUI view data onto the page
            context(pdf)
            
            // 8: End the page and close the file
            pdf.endPDFPage()
            pdf.closePDF()
        }
        
        return url
    }
    
var PdfView: some View { ...
        // Rest of the code
            }
        }
    }
}

问题根源 #

1. 渲染时机错误：render()会在视图初始化、每次刷新时被调用，PDF文件被频繁覆盖，容易引发文件访问冲突。
2. 文件写入未完成就被访问：render()的闭包是异步执行的，代码直接返回URL时，文件可能还没完全写入磁盘，ShareLink访问时就会触发权限/文件损坏错误。

解决方案 #

方案1：优化ShareLink调用逻辑，延迟渲染 #

修改ShareLink的item参数，确保只在用户点击时触发渲染，避免视图刷新时重复执行：

struct ContentView: View {
    var body: some View {
        // ... 原有视图内容
        .toolbar {
            ToolbarItemGroup {
                ShareLink("Export PDF", item: {
                    return render()
                }())
            }
        }
    }
    
    // 保留原有render方法，添加旧文件清理逻辑
    func render() -> URL {
        let renderer = ImageRenderer(content: PdfView)
        let url = URL.documentsDirectory.appending(path: "test.pdf")
        
        // 先清理旧文件，避免写入冲突
        do {
            if FileManager.default.fileExists(atPath: url.path) {
                try FileManager.default.removeItem(at: url)
            }
        } catch {
            print("清理旧PDF失败：\(error)")
        }
        
        renderer.render { size, context in
            var box = CGRect(x: 0, y: 0, width: size.width, height: size.height)
            guard let pdf = CGContext(url as CFURL, mediaBox: &box, nil) else {
                return
            }
            pdf.beginPDFPage(nil)
            context(pdf)
            pdf.endPDFPage()
            pdf.closePDF()
        }
        
        return url
    }
    
    // ... PdfView定义
}

方案2：异步渲染+手动触发分享（更稳妥） #

改用异步渲染逻辑，确保文件完全写入后再调用分享界面，彻底避免访问时机问题：

struct ContentView: View {
    var body: some View {
        // ... 原有视图内容
        .toolbar {
            ToolbarItemGroup {
                Button("Export PDF") {
                    render { url in
                        guard let pdfURL = url else { return }
                        // 手动调用系统分享界面
                        let activityVC = UIActivityViewController(activityItems: [pdfURL], applicationActivities: nil)
                        UIApplication.shared.windows.first?.rootViewController?.present(activityVC, animated: true)
                    }
                }
            }
        }
    }
    
    // 改为异步渲染，完成后通过回调返回URL
    func render(completion: @escaping (URL?) -> Void) {
        let renderer = ImageRenderer(content: PdfView)
        let url = URL.documentsDirectory.appending(path: "test.pdf")
        
        // 清理旧文件
        do {
            if FileManager.default.fileExists(atPath: url.path) {
                try FileManager.default.removeItem(at: url)
            }
        } catch {
            print("清理旧PDF失败：\(error)")
            completion(nil)
            return
        }
        
        renderer.render { size, context in
            var box = CGRect(x: 0, y: 0, width: size.width, height: size.height)
            guard let pdf = CGContext(url as CFURL, mediaBox: &box, nil) else {
                completion(nil)
                return
            }
            pdf.beginPDFPage(nil)
            context(pdf)
            pdf.endPDFPage()
            pdf.closePDF()
            
            // 回到主线程返回结果
            DispatchQueue.main.async {
                completion(url)
            }
        }
    }
    
    // ... PdfView定义
}

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