如何实现数据库仅一次性预填充？解决CloudKit同步重复数据问题

方案1：结合UserDefaults标记与CloudKit同步通知 #

核心思路是用本地标记记录是否已完成预填充，同时等待CloudKit同步完成后再执行检查逻辑，避免本地数据未同步完全时误触发填充。

实现代码： #

func setupDataPrepopulation() {
    let container = sharedModelContainer
    // 监听CloudKit远程同步完成通知
    NotificationCenter.default.addObserver(forName: .NSPersistentCloudKitContainerRemoteChange, object: container, queue: .main) { [weak self] _ in
        self?.checkAndPopulateAfterSync(modelContext: container.mainContext)
    }
    
    // 应用启动时先执行一次初始检查
    checkAndPopulateAfterSync(modelContext: container.mainContext)
}

func checkAndPopulateAfterSync(modelContext: ModelContext) {
    let hasPrepopulated = UserDefaults.standard.bool(forKey: "hasPrepopulatedData")
    guard !hasPrepopulated else { return }
    
    let fetchRequest = FetchDescriptor<PredefItem>()
    do {
        let existingRecords = try modelContext.fetch(fetchRequest)
        if existingRecords.isEmpty {
            populatePredefinedData(modelContext: modelContext)
            // 标记预填充完成，避免后续重复执行
            UserDefaults.standard.set(true, forKey: "hasPrepopulatedData")
            try modelContext.save()
        }
    } catch {
        print("查询预定义数据失败: \(error)")
    }
}

使用方式： #

将原init中的直接调用替换为调用setupDataPrepopulation()，例如在App的初始化或主视图的onAppear中触发。这样首次启动时，若CloudKit同步未完成，本地数据为空但不会标记已填充；等同步完成收到通知后再次检查，若云端数据已同步到本地，就不会执行填充；若云端确实无数据，则完成填充并标记。

方案2：用CloudKit同步的状态实体标记预填充状态 #

创建一个仅存单条记录的SyncStatus实体，同步到CloudKit，通过该实体的状态判断是否需要预填充，确保跨设备/重装后的状态一致性。

步骤： #

1. 在Core Data模型中添加SyncStatus实体，包含isPrepopulated（Bool类型）属性，并开启CloudKit同步。
2. 实现检查逻辑：

func checkAndPopulateWithCloudKitMarker(modelContext: ModelContext) {
    let statusFetch = FetchDescriptor<SyncStatus>()
    do {
        let statusRecords = try modelContext.fetch(statusFetch)
        if let status = statusRecords.first {
            guard !status.isPrepopulated else { return }
            
            populatePredefinedData(modelContext: modelContext)
            status.isPrepopulated = true
            try modelContext.save()
        } else {
            // 无状态记录，说明是首次使用（含重装且云端无数据）
            populatePredefinedData(modelContext: modelContext)
            let newStatus = SyncStatus()
            newStatus.isPrepopulated = true
            modelContext.insert(newStatus)
            try modelContext.save()
        }
    } catch {
        print("检查同步状态失败: \(error)")
    }
}

优化： #

同样结合NSPersistentCloudKitContainerRemoteChange通知，等待CloudKit同步完成后再执行上述检查，避免本地未同步到云端状态时误操作。

方案3：延迟预填充（简易但可靠性较低） #

如果对实时性要求不高，可以在应用启动后延迟一段时间再执行检查，给CloudKit留出同步时间：

init() {
    DispatchQueue.main.asyncAfter(deadline: .now() + 3) {
        self.checkAndPopulateData(modelContext: sharedModelContainer.mainContext)
    }
}

该方法优点是实现简单，但无法保证所有场景下同步都能在延迟时间内完成，仅适合测试或低要求场景。

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