Core Data结合CloudKit时同objectId记录重复问题排查与预防

我开发的Swift应用采用Core Data结合CloudKit技术，发现CloudKit在所有设备的容器中复制了全部记录，且重复记录拥有相同的objectId。我的代码使用了NSMergeByPropertyObjectTrumpMergePolicy，原以为CloudKit会在Apple服务器端合并记录，请问该问题的成因是什么？如何预防？

class DataManager: NSObject, ObservableObject {
    private var containerImpl: NSPersistentContainer? = nil
    
    var container: NSPersistentContainer {
        if containerImpl == nil {
            containerImpl = makeLazyContainer()
        }
        return containerImpl!
    }
    
    var privatePersistentStore: NSPersistentStore?
    
    private func makeLazyContainer() -> NSPersistentContainer {
        var container: NSPersistentContainer? = nil

        let dontSyncToiCloud = UserDefaults.standard.bool(forKey: "dontSyncToiCloud")
        var cloudContainer : NSPersistentCloudKitContainer? = nil
        if !dontSyncToiCloud {
            print("syncing to iCloud")
            cloudContainer = NSPersistentCloudKitContainer(name: "Model")
            container = cloudContainer
        } else {
            print("not syncing to iCloud")
            container = NSPersistentContainer(name: "Model")
        }
        
        let description = container!.persistentStoreDescriptions.first
        description!.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
        description!.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
        
        container!.loadPersistentStores(completionHandler: {
            (storeDescription, error) in
            if let error = error as NSError? {
                fatalError("Unresolved error \(error), \(error.userInfo)")
            } else {
                self.privatePersistentStore = container!.persistentStoreCoordinator.persistentStore(for: storeDescription.url!)
            }
        })
        
        container!.viewContext.automaticallyMergesChangesFromParent = true
        container!.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy

        if !dontSyncToiCloud {
#if DEBUG
            do {
                print("initialize the development schema")
                try cloudContainer!.initializeCloudKitSchema(options: [])
            } catch {
                print("error: \(error.localizedDescription)")
            }
#endif
        }
        
        do {
            try container!.viewContext.setQueryGenerationFrom(.current)
        } catch {
            fatalError("###\(#function): Failed to pin viewContext to the current generation:\(error)")
        }
        
        return container!
    }
}

• CloudKit服务器无自动合并逻辑：CloudKit不会在服务器层面自动合并拥有相同objectId的记录。objectId是Core Data本地生成的标识，若多台设备在离线状态下创建了相同objectId的记录，后续同步时服务器会将它们视为独立记录，不会主动合并。
• 合并策略仅作用于本地上下文：NSMergeByPropertyObjectTrumpMergePolicy是Core Data本地上下文的合并规则，仅在本地合并变更（比如接收远程同步数据、上下文间合并）时生效，完全不涉及CloudKit服务器端的处理逻辑。你之前对合并策略的作用范围理解有误。
• 容器类型切换导致存储脱节：代码中根据用户设置在NSPersistentContainer和NSPersistentCloudKitContainer之间切换，若用户先关闭同步再重新开启，本地存储的记录未关联CloudKit标识，重新同步时会被当作新记录上传，与其他设备已有的同objectId记录形成重复。
• 持久化历史追踪未正确处理：虽然开启了持久化历史追踪，但如果没有配套的变更合并逻辑，远程同步的变更可能无法通过合并策略正确处理，导致重复记录留存。

• 统一使用NSPersistentCloudKitContainer：不要切换容器类型，即使用户关闭同步，也保留NSPersistentCloudKitContainer，通过禁用CloudKit选项实现本地存储：

  let dontSyncToiCloud = UserDefaults.standard.bool(forKey: "dontSyncToiCloud")
  let container = NSPersistentCloudKitContainer(name: "Model")
  
  let description = container.persistentStoreDescriptions.first!
  description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
  description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
  
  if dontSyncToiCloud {
      description.cloudKitContainerOptions = nil // 禁用CloudKit同步
  }
  

  这样可避免本地存储与CloudKit容器脱节，防止重新同步时上传重复记录。
• 给所有上下文设置合并策略：除了viewContext，所有私有队列上下文也需要设置相同的合并策略，因为同步过程中的变更可能在私有队列中处理，viewContext的策略不会自动覆盖其他上下文。
• 确保objectId全局唯一：虽然Core Data正常同步时objectId会关联CloudKit的recordName（默认唯一），但离线场景下需避免多设备生成相同objectId。可通过自定义生成全局唯一标识（比如UUID）作为实体的唯一字段，并在CloudKit中设置该字段为唯一索引，同步时先检查云端是否存在同标识记录。
• 实现持久化历史合并逻辑：监听NSPersistentStoreRemoteChangeNotification，定期处理持久化历史，将远程变更合并到所有上下文中，确保合并策略生效，清理重复记录。
• 规范Debug模式Schema初始化：保持仅在Debug模式初始化Schema，但要使用initializeCloudKitSchema(options: .printSchema)等选项，避免重复创建Schema，减少潜在的同步异常。

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