Swift iOS应用版本升级CoreData迁移触发表已存在错误崩溃求助

崩溃的核心原因是CoreData自动迁移过程中尝试创建ZEKYCINFO表，但本地已有同名表导致SQL执行失败，具体可归为以下几类场景：

• 你在1.5.0版本对应的第3版数据模型中新增了ZEKYCINFO实体，但1.4.3版本的代码中存在手动执行原生SQL创建ZEKYCINFO表的逻辑，CoreData感知不到手动创建的表，迁移时仍然尝试新建表触发冲突
• 第3版数据模型创建时没有正确基于第2版的副本修改，或者曾经删除过ZEKYCINFO实体后重新添加，自动推断迁移规则时将该实体识别为全新对象，尝试重复建表
• 你对原有实体做了重命名操作改为ZEKYCINFO，但没有配置重命名标识符（Renaming ID），CoreData误以为是删除旧实体、新增新实体，尝试新建ZEKYCINFO表和旧表冲突

1. 先排查冲突根源

• 对比第2版和第3版.xcdatamodeld的差异，确认ZEKYCINFO实体的变更类型：如果是重命名产生的变更，直接在Xcode数据模型检查器中给该实体填写旧实体名作为重命名标识符，自动迁移即可识别重命名操作，不会尝试新建表
• 排查1.4.3版本代码，删除所有手动创建ZEKYCINFO表的原生SQL逻辑，所有表结构变更统一交给CoreData管理

2. 迁移规则优化

• 如果ZEKYCINFO是全新新增的实体，且确认旧版本表是无效残留，你可以自定义迁移策略：迁移前先判断本地是否存在ZEKYCINFO表，如果存在则先删除无效旧表再执行迁移
• 如果表内有需要保留的数据，放弃自动推断迁移，手动创建映射模型（Mapping Model），指定已有ZEKYCINFO表和新实体的映射关系，避免重复建表

3. 兼容 fallback 逻辑优化

• 移除原代码中直接触发fatalError的粗暴处理，增加迁移失败的兼容逻辑，针对Code=134110的迁移错误做降级处理：如果本地数据都是可从服务端恢复的缓存，可以直接删除旧数据库文件重新初始化，避免崩溃

示例兼容代码：

container.loadPersistentStores(completionHandler: { (storeDescription, error) in
    if let error = error as NSError?, error.code == 134110 {
        do {
            // 迁移失败时删除旧库，仅适用于本地数据可恢复的场景
            if let storeUrl = storeDescription.url {
                try FileManager.default.removeItem(at: storeUrl)
                // 重新加载存储
                try container.persistentStoreCoordinator.addPersistentStore(
                    ofType: NSSQLiteStoreType,
                    configurationName: nil,
                    at: storeUrl,
                    options: storeDescription.options
                )
            }
        } catch let recoverError {
            fatalError("Recovery failed: \(recoverError)")
        }
    } else if let error = error as NSError? {
        fatalError("Unresolved error \(error), \(error.userInfo)")
    }
})

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