Swift中CoreData一对多关系修改后触发持久化存储迁移失败错误

问题本质 #

你修改了Answer实体的answeredBy关系，从多对多（原maxCount=0，允许多个Member关联同一个Answer）改为一对多（Answer→Member为一对一），这种涉及关系基数的重大结构变更，CoreData的自动迁移无法自动处理，必须通过自定义映射模型和迁移逻辑来完成数据转换。

具体解决步骤 #

1. 确认模型版本管理 #

确保你已经为修改后的模型创建了新的版本：

• 在.xcdatamodeld文件上右键，选择"Add Model Version"
• 命名新版本（比如Model v2），并在文件检查器中将其设置为"Current Model Version"

2. 创建自定义映射模型 #

• 新建文件，选择Core Data分类下的Mapping Model
• 选择旧模型版本作为"Source Model"，新模型版本作为"Destination Model"，生成初始映射

3. 编写实体迁移策略类 #

创建继承自NSEntityMigrationPolicy的自定义类，处理Answer实体的数据拆分逻辑：

import CoreData

class AnswerMigrationPolicy: NSEntityMigrationPolicy {
    override func createDestinationInstances(forSource sInstance: NSManagedObject, entityMapping mapping: NSEntityMapping, manager: NSMigrationManager) throws {
        // 获取源Answer对象的所有关联Member
        guard let sourceMembers = sInstance.value(forKey: "answeredBy") as? Set<NSManagedObject> else {
            return
        }
        
        // 为每个Member创建对应的目标Answer实例
        for member in sourceMembers {
            // 创建新的Answer对象
            let destinationAnswer = NSEntityDescription.insertNewObject(forEntityName: "Answer", into: manager.destinationContext)
            
            // 复制原Answer的其他属性
            destinationAnswer.setValue(sInstance.value(forKey: "challenge"), forKey: "challenge")
            destinationAnswer.setValue(sInstance.value(forKey: "team"), forKey: "team")
            destinationAnswer.setValue(sInstance.value(forKey: "videos"), forKey: "videos")
            
            // 设置新的answeredBy关系
            destinationAnswer.setValue(member, forKey: "answeredBy")
            
            // 关联反向关系（Member的answerer）
            member.mutableSetValue(forKey: "answerer").add(destinationAnswer)
            
            // 通知迁移管理器完成映射
            manager.associate(sourceInstance: sInstance, withDestinationInstance: destinationAnswer, for: mapping)
        }
    }
}

4. 关联映射模型与自定义策略 #

• 打开创建的映射模型，选择Answer实体的映射条目
• 在右侧检查器的Custom Policy字段中，填入自定义策略类的完整类名（比如YourAppName.AnswerMigrationPolicy）

5. 配置持久化存储加载选项 #

在加载持久化存储时，确保启用迁移选项：

lazy var persistentContainer: NSPersistentContainer = {
    let container = NSPersistentContainer(name: "YourModelName")
    let description = NSPersistentStoreDescription()
    // 启用自动迁移，并指定使用自定义映射模型
    description.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
    description.setOption(false as NSNumber, forKey: NSInferMappingModelAutomaticallyOption) // 关闭自动推断，使用自定义模型
    container.persistentStoreDescriptions = [description]
    
    container.loadPersistentStores(completionHandler: { (storeDescription, error) in
        if let error = error as NSError? {
            fatalError("Unresolved error \(error), \(error.userInfo)")
        }
    })
    return container
}()

6. 关键注意事项 #

• 唯一性约束调整：原Answer实体的唯一性约束是(challenge, team)，迁移后同一challenge和team下会有多个Answer（对应不同Member），需要修改唯一性约束为(challenge, team, answeredBy)避免冲突
• 数据测试：务必使用包含多Member关联的旧数据测试迁移，验证新生成的Answer实例是否符合预期
• 反向关系处理：确保Member的answerer反向关系正确关联新生成的Answer，避免数据不一致

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