SwiftData中ModelActor引发卡顿与频繁Fetch问题排查优化

原因分析 #

1. ModelContext默认绑定主线程调度：SwiftData的ModelContainer默认生成的ModelContext会关联主线程调度器，即便你创建了独立的Queue容器，若未显式配置后台调度策略，其上下文仍会在主线程执行操作。
2. ModelActor未指定专属后台上下文：遵循ModelActor协议的Actor默认复用容器的主上下文，不给TasksQueue绑定独立的后台ModelContext的话，所有增删查操作都会跑到主线程执行，引发卡顿。
3. 上下文通知触发额外Fetch请求：默认情况下，ModelContext的变更会发送通知，即便Queue容器与UI隔离，若未关闭通知，可能间接触发UI相关的Fetch请求，加重主线程负担。

修改方案 #

1. 为Queue容器创建后台专属ModelContext #

创建Queue容器时，显式配置后台调度队列，生成独立的后台上下文：

// 配置Queue容器的后台调度策略
let queueContainerConfig = ModelConfiguration(
    for: PendingTask.self,
    transactionScheduler: SerialDispatchQueueScheduler(queue: DispatchQueue(label: "com.yourapp.queue-container"))
)

// 初始化Queue容器
let queueContainer = try ModelContainer(for: PendingTask.self, configurations: queueContainerConfig)

// 获取容器对应的后台上下文
let queueBackgroundContext = queueContainer.context(for: queueContainerConfig)

2. 让TasksQueue绑定后台上下文 #

实现ModelActor时，显式传入后台上下文，同时关闭不必要的上下文特性：

actor TasksQueue: ModelActor {
    let modelContext: ModelContext

    init(modelContext: ModelContext) {
        self.modelContext = modelContext
        // 关闭自动保存和变更通知，避免触发UI相关逻辑
        modelContext.autosaveEnabled = false
        modelContext.notificationEnabled = false
    }

    func removeTask(_ task: PendingTask) throws {
        modelContext.delete(task)
        try modelContext.save()
    }

    func fetchNextTask() async throws -> PendingTask? {
        let fetchDescriptor = FetchDescriptor<PendingTask>(sortBy: [SortDescriptor(\.createdAt)])
        fetchDescriptor.fetchLimit = 1
        return try modelContext.fetch(fetchDescriptor).first
    }
}

// 初始化TasksQueue时传入后台上下文
let tasksQueue = TasksQueue(modelContext: queueBackgroundContext)

3. 确保操作完全在Actor上下文执行 #

所有针对PendingTask的操作都通过TasksQueue Actor异步调用，避免在主线程直接执行相关逻辑：

// 主线程或其他上下文调用时，通过await将操作调度到后台Actor
await tasksQueue.removeTask(targetTask)

内容的提问来源于stack exchange，提问作者D.Schall