如何从CloudKit中检索引用列表字段？

你直接将CloudKit返回的字段强制转为[Friend]是行不通的——因为CloudKit的引用列表存储的是CKRecord.Reference类型数组，不是你定义的本地Friend结构体。正确的步骤是先取出引用，再批量获取对应的记录，最后映射为本地模型。

第一步：给本地模型添加CKRecord初始化方法 #

首先需要给Friend结构体添加从CKRecord初始化的方法，方便后续转换：

struct Friend {
    let id: UUID
    let username: String
    
    // 从CKRecord初始化
    init?(record: CKRecord) {
        guard let username = record["username"] as? String,
              let recordIDString = record.recordID.recordName,
              let id = UUID(uuidString: recordIDString) else {
            return nil
        }
        self.id = id
        self.username = username
    }
}

第二步：修改检索代码 #

调整你的检索逻辑，先取出引用数组，再批量获取好友记录：

@State var friends = [Friend]()

if let userID = UserDefaults.standard.string(forKey: "userID") {
    let publicDatabase = CKContainer.default().publicCloudDatabase
    let userRecordID = CKRecord.ID(recordName: userID)
    
    publicDatabase.fetch(withRecordID: userRecordID) { (record, error) in
        // 处理用户记录获取错误
        guard let fetchedInfo = record, error == nil else {
            print("获取用户记录失败: \(error?.localizedDescription ?? "未知错误")")
            return
        }
        
        // 取出好友引用列表（类型是[CKRecord.Reference]）
        guard let friendReferences = fetchedInfo["friends"] as? [CKRecord.Reference] else {
            print("未找到好友引用列表")
            return
        }
        
        // 将引用转为CKRecord.ID数组
        let friendRecordIDs = friendReferences.map { $0.recordID }
        
        // 批量获取好友记录
        publicDatabase.fetchRecords(withIDs: friendRecordIDs) { (recordsByID, error) in
            guard let friendRecords = recordsByID?.values, error == nil else {
                print("获取好友记录失败: \(error?.localizedDescription ?? "未知错误")")
                return
            }
            
            // 将CKRecord转为本地Friend模型，过滤初始化失败的实例
            let fetchedFriends = friendRecords.compactMap(Friend.init(record:))
            
            // 切换到主线程更新UI（CloudKit回调在后台线程）
            DispatchQueue.main.async {
                self.friends = fetchedFriends
            }
        }
    }
}

关键注意点 #

• 禁止强制解包as? [Friend]，类型不匹配会直接导致崩溃
• CloudKit的网络回调运行在后台线程，更新@State变量必须切换到主线程
• 使用fetchRecords(withIDs:)批量获取记录，比循环单个获取效率更高
• 处理可选值时做好错误兜底，避免因数据异常导致崩溃

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