修改CoreData实体属性类型并手动生成子类的数据迁移咨询

核心前提 #

由于你是手动生成NSManagedObject子类，无法依赖Xcode自动子类配合轻量迁移，必须手动处理类型转换逻辑，完成跨版本数据迁移。

具体操作步骤 #

1. 创建新版本数据模型 #

• 右键CoreData模型文件（.xcdatamodeld），选择Add Model Version创建新模型版本。
• 在新模型中修改目标属性的类型（例如String转Int16、Date转String等）。
• 选中.xcdatamodeld文件，在右侧Inspector面板将新模型设置为Current Version。

2. 更新手动生成的NSManagedObject子类 #

• 完全同步子类中对应属性的类型，确保和新模型一致。比如原代码@NSManaged public var age: String?改为@NSManaged public var age: Int16?。
• 若涉及可选属性转非可选，必须在迁移逻辑中为旧数据补全默认值，避免运行时崩溃。

3. 实现自定义迁移策略（核心） #

属性类型变更属于非轻量迁移，需自定义NSEntityMigrationPolicy子类处理类型转换：

• 创建Swift/OC类，继承自NSEntityMigrationPolicy。
• 重写createDestinationInstances(forSource:manager:error:)方法，完成旧属性到新属性的转换：

override func createDestinationInstances(forSource sInstance: NSManagedObject, in mapping: NSEntityMapping, manager: NSMigrationManager) throws {
    // 创建目标实体实例
    let destination = NSEntityDescription.insertNewObject(forEntityName: mapping.destinationEntityName!, into: manager.destinationContext)
    
    // 遍历属性，拷贝无需转换的字段，处理目标属性的类型转换
    for property in mapping.sourceEntityAttributes! {
        let key = property.name
        if key == "age" { // 替换为你需要转换的属性名
            // 示例：String类型转Int16类型
            if let oldValue = sInstance.value(forKey: key) as? String, let intValue = Int16(oldValue) {
                destination.setValue(intValue, forKey: key)
            } else {
                // 转换失败时设置默认值
                destination.setValue(0, forKey: key)
            }
        } else {
            // 其他属性直接拷贝
            let value = sInstance.value(forKey: key)
            destination.setValue(value, forKey: key)
        }
    }
    
    // 通知迁移管理器完成当前实例映射
    manager.associate(sourceInstance: sInstance, withDestinationInstance: destination, for: mapping)
}

4. 配置迁移映射模型 #

• 新建文件选择Core Data → Mapping Model，选择旧模型版本为源、新模型版本为目标。
• 在映射模型中选中对应实体映射，右侧Inspector的Custom Policy字段填入你创建的迁移策略类名（例如AgeMigrationPolicy）。

5. 配置PersistentContainer迁移选项 #

初始化NSPersistentContainer时开启迁移支持，强制使用自定义映射模型：

lazy var persistentContainer: NSPersistentContainer = {
    let container = NSPersistentContainer(name: "YourModelName")
    let storeDescription = NSPersistentStoreDescription()
    storeDescription.shouldMigrateStoreAutomatically = true
    storeDescription.shouldInferMappingModelAutomatically = false // 关闭自动推断，使用自定义映射
    container.persistentStoreDescriptions = [storeDescription]
    
    container.loadPersistentStores(completionHandler: { (storeDescription, error) in
        if let error = error as NSError? {
            fatalError("CoreData迁移/加载失败: \(error), \(error.userInfo)")
        }
    })
    return container
}()

6. 测试迁移逻辑 #

• 先运行旧版本APP生成测试数据，再安装新版本APP。
• 验证数据是否正确转换，无丢失、无崩溃。

注意事项 #

• 复杂类型转换（如Int转Data、自定义对象类型变更）需在迁移策略中编写对应转换逻辑。
• 每次模型变更后，必须确保手动生成的子类与模型完全同步，否则会触发运行时错误。
• 迁移前务必备份测试数据，避免不可逆的数据丢失。

内容的提问来源于stack exchange，提问作者Gopalakrishnan G.S.R