使用SwiftData与CloudKit时避免预填充容器数据重复

核心问题原因 #

你的预填充逻辑仅判断本地数据库是否为空，但开启CloudKit后，多设备会在云端同步完成前各自插入36条默认记录，导致云端出现设备数量×36的重复数据——本质是没有基于Record的唯一标识（storageBank+storageSlot组合）做全局去重校验。

最佳解决步骤 #

1. 给Record模型添加全局唯一约束字段 #

基于storageBank和storageSlot的组合生成唯一ID，并标记为SwiftData的唯一属性，让CloudKit能识别重复记录并自动处理冲突：

import SwiftData

enum Bank: String, Codable, CaseIterable {
    case bank1, bank2, bank3, bank4, bank5, bank6
}

enum Slot: String, Codable, CaseIterable {
    case slot1, slot2, slot3, slot4, slot5, slot6
}

@Model
class Record {
    var storageBank: Bank
    var storageSlot: Slot
    @Attribute(.unique) var uniqueId: String // 唯一约束字段
    // 其他用户可修改字段示例
    var note: String
    
    init(storageBank: Bank, storageSlot: Slot, note: String) {
        self.storageBank = storageBank
        self.storageSlot = storageSlot
        // 用枚举rawValue拼接生成稳定的唯一ID
        self.uniqueId = "\(storageBank.rawValue)-\(storageSlot.rawValue)"
        self.note = note
    }
}

2. 修改预填充逻辑：基于唯一ID校验，而非本地数据库是否为空 #

预填充前先等待CloudKit同步完成，再逐个检查默认记录的唯一ID是否已存在（包含云端同步过来的记录），不存在才插入：

func prefillRecordsIfNeeded(in container: ModelContainer) async {
    let context = container.mainContext
    
    // 等待CloudKit完成初始同步，确保本地拿到云端最新数据
    do {
        try await context.enqueueCloudKitOperation(.fetchChanges)
    } catch {
        print("CloudKit同步失败：\(error)")
        return
    }
    
    for defaultRecord in DefaultRecords.contents {
        // 查询是否已存在相同uniqueId的记录
        let fetchDescriptor = FetchDescriptor<Record>(
            predicate: #Predicate { $0.uniqueId == defaultRecord.uniqueId }
        )
        
        do {
            let existingRecords = try context.fetch(fetchDescriptor)
            if existingRecords.isEmpty {
                context.insert(defaultRecord)
            }
        } catch {
            print("查询记录失败：\(error)")
        }
    }
    
    // 保存预填充结果
    do {
        try context.save()
    } catch {
        print("预填充保存失败：\(error)")
    }
}

3. 优化：限制预填充仅在iOS端执行 #

因为watchOS端仅展示数据，无需本地预填充，直接通过CloudKit同步iOS端的数据即可，进一步减少重复风险。在iOS端的启动逻辑中调用上述预填充函数，watchOS端跳过该步骤。

额外注意事项 #

• 唯一ID必须稳定：基于枚举rawValue拼接的方式不会随设备或版本变化，是可靠的全局唯一标识。
• 冲突处理：CloudKit会自动处理相同唯一ID的记录冲突，默认保留最后修改的版本；如果预填充的初始值完全一致，多设备插入也不会产生实际冲突。
• 异步执行：预填充逻辑要放在异步线程中执行，避免阻塞UI。

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