Swift 4 CloudKit queryCompletionBlock未执行且数据拉取不完整

看起来你遇到了CloudKit查询里很典型的新手坑——没处理分页机制，再加上可能的操作生命周期管理不当，导致只能拿到部分数据，还触发不了完成回调。结合你的描述（370条数据最多拉60条、完成块不执行），我来帮你梳理问题和修正方案：

核心问题分析 #

1. CloudKit的分页限制：CloudKit默认单次CKQueryOperation最多返回100条记录（实际返回量可能因服务器策略略有波动，这就是你有时拿到5条有时30多条的原因），如果不处理分页游标（CKQueryCursor），根本拿不到全部数据。
2. resultsLimit参数设置错误：这个参数是给CKQueryOperation实例设置的，不是给CKQuery对象，如果你设错了位置，自然不会生效。
3. 操作生命周期未管理好：如果你的CKQueryOperation是局部变量，且没有正确添加到CloudKit的数据库操作队列，可能会被提前释放，导致查询中途终止，完成块也不会执行。

修正后的完整代码示例 #

func fetchAllRemoteFunctions() {
    // 1. 构建查询条件和查询对象
    let predicate = NSPredicate(value: true)
    let query = CKQuery(recordType: "RemoteFunction", predicate: predicate)
    
    // 2. 创建查询操作，初始化时传入查询对象
    let initialOperation = CKQueryOperation(query: query)
    
    // 3. 设置单次拉取的最大条数（用系统最大值即可）
    initialOperation.resultsLimit = CKQueryOperation.maximumResults
    
    // 4. 存储所有拉取到的记录（用闭包捕获，确保生命周期）
    var allRecords: [CKRecord] = []
    
    // 5. 处理每条返回的记录
    initialOperation.recordMatchedBlock = { recordID, record in
        allRecords.append(record)
        // 可选：打印进度，方便调试
        print("已拉取记录: \(recordID.recordName)，当前总数: \(allRecords.count)")
    }
    
    // 6. 定义完成回调（复用这个闭包处理分页）
    let completionHandler: (CKQueryCursor?, Error?) -> Void = { cursor, error in
        if let error = error {
            print("查询出错: \(error.localizedDescription)")
            return
        }
        
        // 如果有游标，说明还有数据没拉取，递归创建下一页操作
        if let nextCursor = cursor {
            let nextOperation = CKQueryOperation(cursor: nextCursor)
            nextOperation.resultsLimit = CKQueryOperation.maximumResults
            nextOperation.recordMatchedBlock = initialOperation.recordMatchedBlock
            nextOperation.queryCompletionBlock = completionHandler
            
            // 把下一页操作添加到CloudKit数据库队列
            CKContainer.default().publicCloudDatabase.add(nextOperation)
        } else {
            // 所有数据拉取完成，在这里处理结果
            print("✅ 拉取完成！共获取\(allRecords.count)条记录")
            // TODO: 在这里使用allRecords做后续处理
        }
    }
    
    // 7. 给初始操作绑定完成回调
    initialOperation.queryCompletionBlock = completionHandler
    
    // 8. 必须把操作添加到CloudKit的数据库操作队列，否则不会执行
    CKContainer.default().publicCloudDatabase.add(initialOperation)
}

关键注意点 #

• 分页处理：每次查询完成后，如果返回了CKQueryCursor，就必须用这个游标创建新的CKQueryOperation继续拉取下一页，直到游标为nil，才代表所有数据拉取完毕。
• 操作队列：一定要通过CKDatabase.add(_:)把操作添加到CloudKit的专用队列，不要自己随便创建队列（除非你有特殊需求），这样能保证操作的生命周期和执行顺序。
• 闭包捕获：allRecords通过闭包被捕获，确保在整个查询过程中不会被释放，能持续存储所有记录。
• 权限检查：别忘了在CloudKit控制台确认你的容器权限，确保当前用户有读取RemoteFunction类型记录的权限（如果是私有数据库，还要确保用户已登录）。

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