Core Data迁移期间如何填充新增的UUID属性？

核心结论 #

不需要手动迁移，通过轻量级迁移+实体类的默认值处理就能搞定，既满足CloudKit的可选属性要求，又能保证所有实体（包括旧数据和新创建数据）都拥有有效UUID。

具体实现步骤 #

1. 模型层配置 #

• 在Core Data模型编辑器中，给目标实体添加id属性：
  • 类型选择UUID
  • 勾选可选（适配CloudKit同步需求，同时支持轻量级迁移）
  • 不要设置模型层面的默认值（避免和后续代码逻辑冲突）

2. 实体类自动填充逻辑 #

在每个实体对应的NSManagedObject子类中，重写两个生命周期方法，自动补全UUID：

override func awakeFromInsert() {
    super.awakeFromInsert()
    // 新插入的对象自动生成UUID
    if id == nil {
        id = UUID()
    }
}

override func awakeFromFetch() {
    super.awakeFromFetch()
    // 读取旧数据时，若没有UUID则补全并标记修改
    if id == nil {
        id = UUID()
        setValue(id, forKey: "id")
    }
}

3. 开启自动轻量迁移 #

确保Core Data持久化容器配置中开启自动迁移选项：

let container = NSPersistentContainer(name: "YourModelName")
guard let storeDescription = container.persistentStoreDescriptions.first else {
    fatalError("Failed to get persistent store description")
}
// 开启自动迁移和映射模型推断
storeDescription.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
storeDescription.setOption(true as NSNumber, forKey: NSInferMappingModelAutomaticallyOption)

container.loadPersistentStores(completionHandler: { (_, error) in
    if let error = error as NSError? {
        fatalError("Core Data load failed: \(error), \(error.userInfo)")
    }
})

为什么不需要手动迁移？ #

轻量级迁移原生支持“添加可选属性”的场景，而我们通过awakeFromFetch方法，在旧数据第一次被读取时自动补全UUID，相当于在迁移后的首次访问中完成数据填充，无需编写复杂的映射模型或手动迁移代码。

验证方式 #

首次启动应用后，可通过SQLite查看工具打开Core Data数据库，检查所有实体的id字段是否已被正确填充UUID值。

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