NSPersistentHistoryTrackingKey未启用：从NSPersistentContainer迁移至NSPersistentCloudKitContainer

1. 关于NSPersistentHistoryTrackingKey的理解是否正确？ #

正确。Core Data与CloudKit的同步完全依赖持久化历史追踪（Persistent History Tracking，PHT）机制来识别数据变更——不管是离线操作后的后续同步，还是云同步禁用后重新启用，PHT都是Core Data判断哪些本地数据需要同步到云端、哪些云端数据需要合并到本地的核心依据。如果NSPersistentHistoryTrackingKey设为false，Core Data不会记录任何变更历史，同步逻辑无法识别旧数据的存在，就会出现你遇到的旧记录被清除的情况。

2. 能否为NSPersistentHistoryTrackingKey为false时创建的记录开启该功能？ #

可以，但必须通过数据迁移补全历史追踪所需的元数据。直接切换开关不会自动为旧记录生成历史条目——Core Data开启PHT时会为存储添加Z_HISTORY系列系统表来记录变更，旧记录没有这些表中的对应条目，只有通过迁移流程，才能让Core Data为现有数据生成初始的历史快照，将其纳入变更追踪体系。

3. 从NSPersistentHistoryTrackingKey=false的NSPersistentContainer迁移到NSPersistentCloudKitContainer的步骤 #

步骤1：先在NSPersistentContainer中启用PHT并完成本地迁移 #

确保数据模型版本无变更（若有模型修改，需单独处理模型迁移），将NSPersistentHistoryTrackingKey设为true，同时开启远程变更通知，再配置自动迁移：

let container = NSPersistentContainer(name: "YourModelName")
guard let description = container.persistentStoreDescriptions.first else {
    fatalError("Failed to retrieve persistent store description")
}

// 启用持久化历史追踪与远程变更通知
description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
// 启用轻量级自动迁移
description.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
description.setOption(true as NSNumber, forKey: NSInferMappingModelAutomaticallyOption)

container.loadPersistentStores(completionHandler: { (storeDescription, error) in
    if let error = error as NSError? {
        fatalError("Unresolved error \(error), \(error.userInfo)")
    }
})

运行App后，Core Data会为所有旧记录（A、B）生成初始历史追踪条目，确保它们被纳入变更体系。

步骤2：切换到NSPersistentCloudKitContainer并配置CloudKit #

将容器类型替换为NSPersistentCloudKitContainer，保留PHT和迁移配置，同时添加CloudKit容器标识符：

let container = NSPersistentCloudKitContainer(name: "YourModelName")
guard let description = container.persistentStoreDescriptions.first else {
    fatalError("Failed to retrieve persistent store description")
}

// 保留PHT与远程变更配置
description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
// 配置CloudKit容器
let cloudKitOptions = NSPersistentCloudKitContainerOptions(containerIdentifier: "iCloud.com.yourapp.YourContainer")
description.cloudKitContainerOptions = cloudKitOptions
// 保留自动迁移配置
description.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
description.setOption(true as NSNumber, forKey: NSInferMappingModelAutomaticallyOption)

container.loadPersistentStores(completionHandler: { (storeDescription, error) in
    if let error = error as NSError? {
        fatalError("Unresolved error \(error), \(error.userInfo)")
    }
    // 配置自动合并变更与合并策略
    container.viewContext.automaticallyMergesChangesFromParent = true
    container.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy
})

运行App后，Core Data会将所有现有记录（A、B、C、D）的初始状态同步到CloudKit，不会再出现旧记录被清除的问题。

额外注意事项 #

• 测试阶段务必使用测试数据，避免正式环境数据丢失。
• 若App已发布，需分版本完成迁移：先通过版本更新启用PHT并完成本地迁移，再通过后续版本切换到CloudKit同步；若要在同一版本完成，必须确保迁移逻辑稳定。
• 开启PHT后，需定期用NSPersistentHistoryChangeRequest清理历史记录，避免历史表过大影响性能。

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