使用UICloudSharingController遇recordChangeTag指定但记录未找到错误求助

从错误日志来看，核心问题是CloudKit服务器找不到指定的共享记录（CKError 11: Unknown Item，提示recordChangeTag specified, but record not found），即使操作的是已存在的记录，也可能因为本地与云端的同步状态不一致触发该问题。以下是针对性的排查和修复建议：

1. 验证share(for:)方法的可靠性 #

当前逻辑先通过share(for: record)获取已有的共享记录再创建UICloudSharingController，如果这个方法返回的是本地缓存但云端已被删除/从未同步成功的CKShare，就会触发找不到记录的错误。

• 检查share(for:)的实现：确保它返回的CKShare不仅在本地Core Data中存在，还要验证其对应的CloudKit记录是否有效：

  func validateShare(_ share: CKShare, completion: @escaping (Bool) -> Void) {
      let operation = CKFetchRecordsOperation(recordIDs: [share.recordID])
      operation.fetchRecordsCompletionBlock = { records, error in
          DispatchQueue.main.async {
              completion(records?[share.recordID] != nil)
          }
      }
      cloudKitContainer.privateCloudDatabase.add(operation)
  }
  

• 如果验证发现share无效，立即从本地Core Data中删除该关联的share记录，避免后续复用。

2. 修复共享创建后的同步逻辑 #

在创建新共享的回调中，修改CKShare的标题和缩略图后，需要确保这些变更被同步到云端：

self.persistentContainer.share([record], to: nil) { objectIDs, share, container, error in
    if let share = share {
        record.managedObjectContext?.perform { // 改用perform避免阻塞主线程
            share[CKShare.SystemFieldKey.title] = record.title
            share[CKShare.SystemFieldKey.thumbnailImageData] = avatar.pngData()
            do {
                try share.managedObjectContext?.save() // 保存上下文触发CloudKit同步
            } catch {
                print("Failed to save share metadata: \(error)")
            }
        }
    }
    completion(share, container, error)
}

3. 增加错误处理与重试机制 #

当UICloudSharingController返回CKError 11或部分错误时，主动清理无效状态并重试：

• 在UICloudSharingControllerDelegate中处理错误：

  func cloudSharingController(_ csc: UICloudSharingController, failedToSaveShareWithError error: Error) {
      guard let ckError = error as? CKError else { return }
      if ckError.code == .unknownItem {
          // 清除本地无效的share关联
          if let share = share(for: record) {
              record.managedObjectContext?.performAndWait {
                  record.managedObjectContext?.delete(share)
                  try? record.managedObjectContext?.save()
              }
              // 重试创建共享
              DispatchQueue.main.async {
                  self.share(record, avatar: avatar)
              }
          }
      }
  }
  

4. 确保记录已同步到云端再执行共享 #

即使是老记录，也可能因设备离线、同步队列积压等原因未完成云端同步：

• 共享前强制保存上下文，确保本地变更进入同步队列：

  func share(_ record: Record, avatar: UIImage) {
      do {
          try record.managedObjectContext?.save()
      } catch {
          print("Failed to save context before sharing: \(error)")
          return
      }
      // 后续创建并展示UICloudSharingController
      let controller = shareControllerForRecord(record, avatar: avatar)
      // ... 现有代码
  }
  

• 可选：监听NSPersistentCloudKitContainer的同步事件，确认记录上传完成后再允许共享操作：

  // 在viewDidLoad中注册通知
  NotificationCenter.default.addObserver(self, selector: #selector(handleCloudKitEvent(_:)), name: .NSPersistentCloudKitContainerEventChanged, object: persistentContainer)
  
  @objc func handleCloudKitEvent(_ notification: Notification) {
      guard let event = notification.userInfo?[NSPersistentCloudKitContainerEventNotificationKey] as? NSPersistentCloudKitContainer.Event else { return }
      if event.type == .importCompleted || event.type == .exportCompleted {
          // 同步完成，更新UI状态（比如启用共享按钮）
      }
  }
  

5. 处理共享区域的异常状态 #

错误日志中提到的zone属于Core Data CloudKit自动管理的共享区域，若该区域同步异常可能导致共享记录丢失：

• 极端情况下可尝试重置该区域（会丢失本地未同步变更，需谨慎操作）：

  persistentContainer.persistentStoreDescriptions.forEach { description in
      if let cloudKitOptions = description.cloudKitContainerOptions {
          let container = CKContainer(identifier: cloudKitOptions.containerIdentifier)
          let privateDB = container.privateCloudDatabase
          let shareZoneID = CKRecordZone.ID(zoneName: "com.apple.coredata.cloudkit.share.\(cloudKitOptions.databaseScope.rawValue)", ownerName: CKCurrentUserDefaultName)
          let operation = CKModifyRecordZonesOperation(recordZonesToSave: [], recordZoneIDsToDelete: [shareZoneID])
          operation.modifyRecordZonesCompletionBlock = { _, deletedIDs, error in
              if error == nil {
                  persistentContainer.loadPersistentStores(completionHandler: { _, error in
                      // 重新加载PersistentContainer
                  })
              }
          }
          privateDB.add(operation)
      }
  }
  

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