使用CloudKit上传图片至iCloud生成公开链接时遇CKError 5005

问题背景 #

为给OpenAI Image API提供图片链接，使用CloudKit存储图片并生成公共访问URL，已完成iCloud Dashboard配置，但运行代码时触发上述内部错误，核心原因是共享PCS（私有云存储加密信息）为空。

错误根源 #

1. 重复保存记录：原代码先调用publicDatabase.save(record)保存图片记录，随后又在CKModifyRecordsOperation中再次保存同一个记录，导致原子操作区冲突。
2. 共享配置缺失：创建CKShare时未正确配置参与者和权限，导致共享的加密PCS未生成，触发服务器内部错误。
3. 操作流程错误：拆分两次保存操作违反CloudKit原子性要求，引发记录状态不一致。

修正方案 #

• 合并记录保存与共享创建操作，使用CKModifyRecordsOperation一次性提交图片记录和共享对象，保证原子性。
• 为CKShare添加参与者并设置只读权限，确保共享加密信息正确生成。
• 移除重复的记录保存逻辑，调整临时文件清理时机到操作完成后。

修正后的代码 #

import CloudKit
import Foundation

struct GenericError: Error, CustomStringConvertible {
    let message: String
    var description: String { message }
}

extension String {
    static func iCloudContainerIdentifier() throws -> String {
        guard let identifier = Bundle.main.object(forInfoDictionaryKey: "CKContainerIdentifier") as? String else {
            throw GenericError(message: "iCloud容器ID未在Info.plist中配置")
        }
        return identifier
    }
}

extension Data {
    func uploadToCloudKit(completion: @escaping (Result<URL, Error>) -> Void) {
        do {
            let containerIdentifier = try String.iCloudContainerIdentifier()
            let container = CKContainer(identifier: containerIdentifier)
            let publicDatabase = container.publicCloudDatabase

            // 创建Image类型记录
            let record = CKRecord(recordType: "Image")
            
            // 将图片数据写入临时文件
            let tempURL = FileManager.default.temporaryDirectory.appendingPathComponent(UUID().uuidString)
            try self.write(to: tempURL)
            
            // 关联CKAsset到记录
            let imageAsset = CKAsset(fileURL: tempURL)
            record["image"] = imageAsset
            
            // 创建共享并配置权限
            let share = CKShare(rootRecord: record)
            share[CKShare.SystemFieldKey.title] = "Shared Image" as CKRecordValue
            // 添加当前用户为参与者，设置只读权限
            let participant = CKShare.Participant(userIdentity: CKUserIdentity(userRecordID: CKRecordID(recordName: CKCurrentUserDefaultName)), permission: .readOnly)
            share.addParticipant(participant)
            
            // 批量提交记录和共享对象
            let modifyOperation = CKModifyRecordsOperation(recordsToSave: [record, share], recordIDsToDelete: nil)
            modifyOperation.savePolicy = .allKeys
            modifyOperation.modifyRecordsCompletionBlock = { savedRecords, deletedIDs, error in
                // 清理临时文件
                try? FileManager.default.removeItem(at: tempURL)
                
                DispatchQueue.main.async {
                    guard error == nil else {
                        let ckError = error as! CKError
                        var errorMsg: String
                        
                        switch ckError.code {
                        case .networkUnavailable, .networkFailure:
                            errorMsg = "网络异常: \(ckError.localizedDescription)"
                        case .quotaExceeded:
                            errorMsg = "存储空间不足: \(ckError.localizedDescription)"
                        case .partialFailure:
                            let partialMsgs = ckError.partialErrorsByItemID?.map { "记录[\($0.key.recordName)]: \($0.value.localizedDescription)" } ?? []
                            errorMsg = partialMsgs.joined(separator: "; ")
                        case .serverRecordChanged:
                            errorMsg = "服务器记录已更新，请重试: \(ckError.localizedDescription)"
                        case .notAuthenticated:
                            errorMsg = "未登录iCloud账号: \(ckError.localizedDescription)"
                        case .permissionFailure:
                            errorMsg = "权限不足: \(ckError.localizedDescription)"
                        default:
                            errorMsg = "未知错误: \(ckError.localizedDescription)"
                        }
                        completion(.failure(GenericError(message: errorMsg)))
                        return
                    }
                    
                    // 从保存结果中获取共享对象并返回URL
                    guard let share = savedRecords?.first(where: { $0 is CKShare }) as? CKShare, let shareURL = share.url else {
                        completion(.failure(GenericError(message: "无法生成共享链接")))
                        return
                    }
                    completion(.success(shareURL))
                }
            }
            
            publicDatabase.add(modifyOperation)
        } catch {
            completion(.failure(error))
        }
    }
}

额外检查项 #

1. 确认CloudKit Dashboard中Image记录类型已创建，且包含名为image的Asset字段。
2. 确认iCloud容器的权限配置允许公共数据库的读写操作。
3. 测试设备已登录iCloud账号，且开启了iCloud Drive功能。

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