CKSyncEngine.RecordZoneChangeBatch与CKSyncEngineDelegate使用疑难咨询

核心问题拆解 #

1. 多类型记录查找效率瓶颈：示例中的recordProvider仅传入CKRecord.ID，无法直接获取记录类型，导致必须遍历所有记录类型的本地存储查找匹配项，操作成本极高。
2. 属性认知偏差：CKSyncEngine.PendingRecordZoneChange仅包含待同步的记录ID与变更类型（创建/更新/删除），并不存储完整CKRecord；recordsToSave是CKSyncEngine.RecordZoneChangeBatch的属性，而非PendingRecordZoneChange的成员，这是Xcode报错的直接原因。

高效获取CKRecord的实现方案 #

1. 提前维护ID到记录的映射表 #

在本地记录发生变更（创建/更新/标记删除）时，同步维护一个全局或按Zone划分的字典，将CKRecord.ID映射到对应的记录类型与完整记录，避免后续遍历查找：

// 按Zone或全局存储的ID-记录映射表
private var recordLookup: [CKRecord.ID: (type: String, record: CKRecord?)] = [:]

// 记录创建/更新时同步更新映射
func persistLocalRecord(_ record: CKRecord) {
    // 将记录保存到对应类型的本地存储（如Core Data、Realm）
    saveToTypeSpecificStore(recordType: record.recordType, record: record)
    // 更新映射表
    recordLookup[record.recordID] = (type: record.recordType, record: record)
}

// 记录标记删除时保留类型信息
func markLocalRecordAsDeleted(_ recordID: CKRecord.ID, recordType: String) {
    // 在本地存储标记删除状态
    markAsDeletedInTypeStore(recordType: recordType, recordID: recordID)
    // 更新映射表（保留类型用于后续同步处理）
    recordLookup[recordID] = (type: recordType, record: nil)
}

2. 在nextRecordZoneChangeBatch中高效获取记录 #

利用已维护的映射表，直接通过CKRecord.ID定位记录类型与完整记录，彻底避免遍历操作：

func nextRecordZoneChangeBatch(_ context: CKSyncEngine.SendChangesContext, syncEngine: CKSyncEngine) async -> CKSyncEngine.RecordZoneChangeBatch? {
    // 过滤当前上下文需要同步的Zone的待变更记录
    let pendingChanges = syncEngine.state.pendingRecordZoneChanges
        .filter { context.options.zoneIDs.contains($0.zoneID) }
    
    // 通过映射表批量获取记录，无需遍历所有类型
    return await CKSyncEngine.RecordZoneChangeBatch(pendingChanges: pendingChanges) { recordID in
        guard let entry = recordLookup[recordID] else {
            // 未找到记录，可能已被彻底清理，返回nil跳过同步
            return nil
        }
        return entry.record
    }
}

3. 同步完成后清理映射表 #

在sendChangesCompleted回调中，清理已成功同步的记录ID，避免映射表无限膨胀：

func sendChangesCompleted(_ context: CKSyncEngine.SendChangesContext, syncEngine: CKSyncEngine, error: Error?) {
    guard error == nil else { return }
    // 移除已完成同步的记录ID
    context.pendingChanges.forEach {
        recordLookup.removeValue(forKey: $0.recordID)
    }
}

设计理念说明 #

CKSyncEngine的核心设计是让开发者完全掌控本地数据存储，pendingRecordZoneChanges仅作为待同步任务的跟踪器，不负责存储完整记录。因此，维护ID到记录的快速映射是多类型应用提升同步效率的必然方案。

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