如何删除因网络问题未创建完成的CloudKit CKRecord？

我之前在做CloudKit+CoreData同步的项目时，也碰到过一模一样的场景——离线创建本地实体后，网络差导致CloudKit记录没生成成功，需要清理这些“半同步”的记录。给你几个实用的解决思路和代码示例：

第一步：给CoreData实体加同步状态标记 #

首先得在你的Person CoreData实体里加个字段，用来区分记录的同步状态。我一般会加一个syncStatus字段（String类型就行，或者用枚举转存），可选值：

• synced：已成功同步到CloudKit
• pending：待上传（本地已创建，还没尝试同步）
• failed：同步尝试失败

当用户创建Person时，先把syncStatus设为pending，保存到CoreData；然后触发CloudKit上传，成功后更新为synced，失败则改成failed。

第二步：清理未完成的记录 #

根据记录的状态和是否生成过CKRecordID，分两种情况处理：

情况1：还没生成CKRecord的待上传记录 #

这类记录还没和CloudKit产生交互，直接删除CoreData里的Person实体就行，不会有云端残留。

情况2：同步失败已生成CKRecordID的记录 #

这里要先确认云端是否真的没有这条记录（毕竟有时候网络延迟可能后来又成功了），再决定是否删除本地记录：

func cleanUpUnsyncedPersons() {
    let context = yourPersistentContainer.viewContext
    let fetchRequest: NSFetchRequest<Person> = Person.fetchRequest()
    // 筛选出待同步或同步失败的记录
    fetchRequest.predicate = NSPredicate(format: "syncStatus IN %@", ["pending", "failed"])
    
    do {
        let unsyncedPersons = try context.fetch(fetchRequest)
        for person in unsyncedPersons {
            // 如果本地存了对应的CKRecordID，先查云端是否存在
            if let recordIDString = person.cloudKitRecordID, 
               let recordID = CKRecord.ID(recordName: recordIDString) {
                
                let publicDB = CKContainer.default().publicCloudDatabase
                publicDB.fetch(withRecordID: recordID) { [weak self] record, error in
                    guard let self = self else { return }
                    DispatchQueue.main.async {
                        if error != nil || record == nil {
                            // 云端无此记录，删除本地实体
                            context.delete(person)
                            try? context.save()
                        } else {
                            // 云端居然有记录，说明之前的同步延迟成功了，更新本地状态
                            person.syncStatus = "synced"
                            try? context.save()
                        }
                    }
                }
            } else {
                // 没生成过CKRecordID，直接删本地
                context.delete(person)
            }
        }
        // 批量保存无CKRecordID的删除操作
        try context.save()
    } catch {
        print("获取未同步记录失败：\(error.localizedDescription)")
    }
}

额外的最佳实践 #

• 优先重试而非直接删除：可以在用户重新联网时，自动重试failed状态的记录，给用户更好的体验，只有用户主动删除或者重试多次失败后再清理。
• 用操作队列管理同步任务：把每个CloudKit上传任务放到OperationQueue里，这样可以随时取消正在进行的上传（比如用户主动删除时），避免云端意外生成记录。
• 记录同步日志：必要时可以加个syncError字段，记录失败原因，方便排查问题。

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