SwiftUI Core Data+iCloud同步异常排查：非可选Transformable字段问题

本地Core Data存储读取功能正常，实体包含一个非可选的Transformable类型图片字段，启用iCloud同步后出现「字段未设置默认值或未设为可选」的错误。控制台仅输出iCloud与Core Data的正常日志，但多设备UI无法同步数据。已配置好Target容器，开启了Background Modes的通知功能，以下是DataController代码，请求排查问题根源（代码/配置/开发环境临时现象）：

class DataController: ObservableObject{
    @Published var setReminder: String = ""
    @Published var setLenght = ""
    @Published var warrantys = [Warranty]()
    @Published var purchaseDate = Date.now

    @AppStorage("reminder") var reminder = "30"{
        willSet(newValue){
            self.setReminder = newValue
        }
    }
    @AppStorage("warrantyLenght") var warrantyLenght = "24"{
        willSet(newValue){
            self.setLenght = newValue
        }
    }

    var days = ["60", "30", "15"]
    var length = ["48" ,"36", "24", "12"]

    let container: NSPersistentCloudKitContainer

    init(){
        ValueTransformer.setValueTransformer(UIImageTransformer(), forName: NSValueTransformerName("UIImageTransformer"))
        
        container = NSPersistentCloudKitContainer(name: "Data")
        container.viewContext.automaticallyMergesChangesFromParent = true
        container.viewContext.mergePolicy = NSMergeByPropertyStoreTrumpMergePolicy
        container.loadPersistentStores { description, error in
            if let err = error{
                print("Could not load data from core data \(err)")
            }else{
                print("Data loaded")
            }
        }
        self.setReminder = self.reminder
        self.setLenght = self.warrantyLenght
        fetchData()
    }

    func resetSettings(){
        warrantyLenght = self.length[2]
        reminder = self.days[1]
    }

    func fetchData(){
        let request = NSFetchRequest<Warranty>(entityName: "Warranty")
        do{
            self.warrantys = try container.viewContext.fetch(request)
        } catch let error{
            print("Erros fetching default settings \(error)")
        }
    }

    func saveData(){
        do{
            try container.viewContext.save()
            fetchData()
        } catch let error{
            print("Failed to save data \(error.localizedDescription)")
        }
    }

    func addWarranty(setDate: Date, itemName: String, reminder: String, warrantyLength: String, image: UIImage) {
        let calendar = Calendar.current
        var dateComponents = DateComponents()
        dateComponents.month = Int(warrantyLength) ?? 24
        let expirationDate = calendar.date(byAdding: dateComponents, to: setDate) ?? Date()
        
        let item = Warranty(context: container.viewContext)
        item.id = UUID()
        item.purchaseDate = setDate
        item.warrantyLenght = warrantyLength
        item.exparation = expirationDate
        item.itemName = itemName
        item.remindIn = Int64(reminder) ?? 30
        item.image = image
        saveData()
    }

    func deleteWarranty(warranty: Warranty){
        container.viewContext.delete(warranty)
        saveData()
    }
}

问题根源分析与解决方案 #

1. Transformable字段的iCloud兼容性问题 #

CloudKit对自定义Transformable类型的支持存在局限：

• 自定义Transformer（如UIImageTransformer）无法被CloudKit直接识别，同步时可能出现序列化/反序列化失败，导致图片字段值缺失，触发「非可选字段无值」的错误。
• 即使本地创建数据时确保图片字段有值，同步过程中CloudKit解析失败仍会标记字段缺失，阻塞同步流程。

修复方案：

• 将图片字段改为可选类型，或设置默认占位图片作为字段默认值。
• 替换方案：改用Binary Data类型存储图片，CloudKit原生支持Data类型，兼容性更好。修改实体字段类型为Binary Data，存储时将UIImage转为Data：item.imageData = image.pngData()，读取时再转回UIImage。

2. Core Data iCloud配置疏漏 #

• 检查实体的CloudKit映射：在Core Data模型编辑器中，进入实体的「CloudKit」标签，确认图片字段已勾选「Include in CloudKit」。
• 验证CloudKit容器激活状态：在loadPersistentStores回调中添加日志，确认CloudKit配置生效：

  container.loadPersistentStores { description, error in
      if let err = error {
          print("Core Data加载失败: \(err)")
      } else {
          print("CloudKit容器状态: \(description.cloudKitContainerOptions ?? "未配置CloudKit")")
      }
  }
  

3. 同步数据的监听缺失 #

当前代码仅在初始化和保存后调用fetchData()，但iCloud后台同步的变更不会自动触发数据刷新，导致UI无法更新。

修复方案：
在DataController中添加上下文变更监听，自动刷新数据：

init() {
    // ... 现有代码
    // 添加监听
    NotificationCenter.default.addObserver(self, selector: #selector(contextChanged), name: NSManagedObjectContext.didSaveObjectsNotification, object: container.viewContext)
    // ... 现有代码
}

@objc private func contextChanged(_ notification: Notification) {
    fetchData()
}

deinit {
    NotificationCenter.default.removeObserver(self)
}

4. 开发环境临时问题排查 #

• 确保测试设备/模拟器使用同一Apple ID，且已开启iCloud Drive与应用的iCloud权限。
• 重置测试环境：删除App、清空模拟器数据，或在系统设置中重置应用的iCloud数据后重新测试。
• 核对开发者账号的CloudKit容器ID，确保与Target中的配置完全一致。

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