首次启动App时Core Data结合iCloud的数据预填充方案问询

核心问题分析 #

你之前的错误是因为@FetchRequest是SwiftUI View专属的属性包装器，依赖View的环境上下文，不能在PersistenceController这类非View类中使用。另外，直接在启动时判断本地数据会忽略iCloud同步延迟，导致iCloud数据还没同步过来就误创建了重复列表。

可行实现方案 #

修改PersistenceController，用Core Data原生的查询方式替代@FetchRequest，同时处理iCloud同步延迟的问题：

class PersistenceController: ObservableObject {
    static let shared = PersistenceController()
    
    let container: NSPersistentCloudKitContainer
    
    init(inMemory: Bool = false) {
        container = NSPersistentCloudKitContainer(name: "YourModelName")
        
        if inMemory {
            container.persistentStoreDescriptions.first!.url = URL(fileURLWithPath: "/dev/null")
        }
        
        container.loadPersistentStores(completionHandler: { (storeDescription, error) in
            if let error = error as NSError? {
                fatalError("Unresolved error \(error), \(error.userInfo)")
            }
            
            // 容器加载完成后执行数据检查
            self.checkAndPrepopulateData()
        })
        
        // 监听iCloud远程数据变化，确保同步完成后更新状态
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(handleRemoteChange),
            name: .NSPersistentStoreRemoteChange,
            object: container.persistentStoreCoordinator
        )
    }
    
    // 检查本地是否已有ListEntity数据
    private func hasExistingLists() -> Bool {
        let fetchRequest: NSFetchRequest<ListEntity> = ListEntity.fetchRequest()
        fetchRequest.resultType = .countResultType // 只统计数量，更高效
        
        do {
            let count = try container.viewContext.count(for: fetchRequest)
            return count > 0
        } catch {
            print("统计列表数量失败: \(error)")
            return false
        }
    }
    
    // 检查并执行预填充逻辑
    private func checkAndPrepopulateData() {
        // 用UserDefaults标记是否已完成预填充，避免重复执行
        let hasPreloaded = UserDefaults.standard.bool(forKey: "DataPreloaded")
        guard !hasPreloaded else { return }
        
        // 先检查本地是否已有数据（可能是iCloud同步过来的）
        if hasExistingLists() {
            UserDefaults.standard.set(true, forKey: "DataPreloaded")
            return
        }
        
        // 延迟1秒再检查，给iCloud同步留时间
        DispatchQueue.main.asyncAfter(deadline: .now() + 1.0) { [weak self] in
            guard let self = self else { return }
            
            if !self.hasExistingLists() {
                // 同步后仍无数据，创建默认列表
                self.createDefaultList()
                UserDefaults.standard.set(true, forKey: "DataPreloaded")
            } else {
                // iCloud同步完成已有数据，标记为已预填充
                UserDefaults.standard.set(true, forKey: "DataPreloaded")
            }
        }
    }
    
    // 创建默认ListEntity
    private func createDefaultList() {
        let defaultList = ListEntity(context: container.viewContext)
        defaultList.name = "默认列表"
        // 可添加其他属性初始化逻辑
        
        do {
            try container.viewContext.save()
        } catch {
            print("保存默认列表失败: \(error)")
        }
    }
    
    // 处理iCloud远程数据变化通知
    @objc private func handleRemoteChange(_ notification: Notification) {
        let hasPreloaded = UserDefaults.standard.bool(forKey: "DataPreloaded")
        guard !hasPreloaded else { return }
        
        if hasExistingLists() {
            UserDefaults.standard.set(true, forKey: "DataPreloaded")
        }
    }
}

关键说明 #

1. 替代@FetchRequest：用NSFetchRequest的countResultType统计数据数量，无需加载所有实体，且能在非View环境正常运行，避免环境缺失错误。
2. 处理iCloud同步延迟：通过1秒延迟检查，给iCloud首次同步留足时间，避免因本地暂时无数据就误创建默认列表。
3. 防止重复执行：用UserDefaults标记预填充状态，确保无论App重启还是iCloud同步完成，逻辑只执行一次。
4. 监听远程变化：通过NSPersistentStoreRemoteChange通知，在iCloud数据同步完成后及时更新状态，避免重复创建。

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