SwiftUI中如何在View的初始化器中正确启动后台任务

核心问题拆解 #

• 第一个逻辑错误：body渲染逻辑写反
  你现有代码里，if let safeImage = image分支放的是占位视图，else分支才放真实图片，逻辑完全颠倒，就算image赋值成功也只会展示占位。
• 第二个生命周期错误：init阶段@State未生效
  SwiftUI的View是值类型，仅作为渲染描述存在，系统会频繁重建View实例。@State属性的底层持久化存储要等到View被挂载到渲染树之后才会和实例绑定，init阶段你访问的是临时实例，异步回调修改的image属于已经被销毁的临时实例，无法触发当前生效View的重绘，所以不会刷新界面。

推荐实现方案 #

如果你需要提前启动渲染任务（不等onAppear触发），推荐用Swift Concurrency的task(id:)修饰符，它会在View首次挂载、绑定的id（这里是data）变化时自动启动任务，View销毁时自动取消任务，完美适配多FileIcon并行渲染的场景，还能避免GCD容易出现的内存泄漏、重复渲染问题。

修正后的完整代码如下：

import SwiftUI
import PDFKit

struct FileIcon: View {
    let data: Data
    @State private var image: UIImage?

    init(for data: Data) {
        self.data = data
    }

    var body: some View {
        Group {
            if let safeImage = image {
                // 渲染成功展示真实图标
                Image(uiImage: safeImage)
                    .resizable()
                    .scaledToFit()
            } else {
                // 未渲染完成展示占位图
                ProgressView() // 替换为你自己的占位视图
            }
        }
        .task(id: data) { // data变化时自动重启任务
            guard image == nil else { return } // 避免重复渲染
            // 后台执行重逻辑
            let renderedImage = await renderImageFromPDF(data: data)
            // Task回调默认在主队列执行，不需要手动切队列
            image = renderedImage
        }
    }

    // 渲染逻辑封装成异步方法
    private func renderImageFromPDF(data: Data) async -> UIImage? {
        guard let document = PDFDocument(data: data),
              let page = document.page(at: 0) else {
            return nil
        }
        let pageSize = page.bounds(for: .mediaBox)
        let renderer = UIGraphicsImageRenderer(size: pageSize)
        return renderer.image { context in
            UIColor.white.set()
            context.fill(CGRect(origin: .zero, size: pageSize))
            context.cgContext.translateBy(x: 0, y: pageSize.height)
            context.cgContext.scaleBy(x: 1, y: -1)
            page.draw(with: .mediaBox, to: context.cgContext)
        }
    }
}

特殊场景：从init启动任务的实现 #

如果确实有特殊场景需要在init阶段就启动任务，你需要用@StateObject持有一个任务管理类，避免临时实例销毁导致任务失效：

struct FileIcon: View {
    let data: Data
    @State private var image: UIImage?
    @StateObject private var taskManager = RenderTaskManager()

    init(for data: Data) {
        self.data = data
        // init阶段启动任务，交给class类型的taskManager持有，不会随临时实例销毁
        taskManager.startRender(data: data) { [weak self] renderedImage in
            DispatchQueue.main.async {
                self?.image = renderedImage
            }
        }
    }

    // body和渲染逻辑和上面一致
}

class RenderTaskManager: ObservableObject {
    private var currentTask: DispatchWorkItem?

    func startRender(data: Data, completion: @escaping (UIImage?) -> Void) {
        // 避免重复启动任务
        guard currentTask == nil else { return }
        let task = DispatchWorkItem {
            // 这里放你的PDF渲染逻辑
            guard let document = PDFDocument(data: data),
                  let page = document.page(at: 0) else {
                completion(nil)
                return
            }
            let pageSize = page.bounds(for: .mediaBox)
            let renderer = UIGraphicsImageRenderer(size: pageSize)
            let renderedImage = renderer.image { context in
                UIColor.white.set()
                context.fill(CGRect(origin: .zero, size: pageSize))
                context.cgContext.translateBy(x: 0, y: pageSize.height)
                context.cgContext.scaleBy(x: 1, y: -1)
                page.draw(with: .mediaBox, to: context.cgContext)
            }
            DispatchQueue.main.async {
                completion(renderedImage)
            }
        }
        currentTask = task
        DispatchQueue.global(qos: .userInitiated).async(execute: task)
    }

    deinit {
        currentTask?.cancel()
    }
}

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