为含继承关系的.xcdatamodel模型添加新版本时遭遇CoreData自动迁移属性冲突问题

这问题我之前帮开发者踩过类似的坑，尤其是iOS14上CoreData处理实体继承的自动迁移时，确实有个容易忽略的bug。咱们先解决当前的迁移报错，再讲移除继承关系的完整步骤。

一、解决“height属性冲突”的即时方案 #

1. 排查模型文件的残留配置 #

有时候旧模型版本的底层XML里会残留已删除的属性记录，导致自动迁移时误判：

• 右键你的.xcdatamodeld文件 → 选择Open As → Source Code
• 搜索<entity name="Maple">相关的代码块，检查是否有<attribute name="height">的残留定义
• 如果有，直接删除这段残留代码，保存后重新编译测试

2. 手动生成映射模型（推荐，彻底避免自动映射bug） #

iOS14的自动映射模型生成逻辑在处理实体继承时容易出错，手动生成映射模型可以精准控制迁移规则：

• 打开CoreData模型文件，切换到新的模型版本
• 顶部菜单选择Editor → Create Mapping Model，选择旧模型版本到新模型版本的映射
• 在生成的映射模型里，找到Maple实体的映射条目：
  • 确认属性列表里没有显式添加height（因为它是从Tree继承的，不需要在子实体映射里重复定义）
  • 如果有重复的height属性，直接删除它
• 保存映射模型后，保持你的迁移代码不变（保留NSMigratePersistentStoresAutomaticallyOption和NSInferMappingModelAutomaticallyOption为true），CoreData会优先使用手动生成的映射模型，避开自动映射的bug

3. iOS14临时 workaround（快速解决） #

如果赶时间上线，可以临时添加一个过渡属性绕过bug：

• 在新模型版本的Maple实体里，添加一个和Tree的height属性完全一致的属性（名字、类型、约束都要匹配）
• 把这个属性设置为Transient（临时属性，不存储到数据库）
• 执行迁移后，下一个模型版本可以删掉这个临时属性，继承关系会正常生效

二、移除实体继承关系的完整指南 #

如果想彻底去掉Maple和Tree的继承关系，需要确保数据完整迁移，步骤如下：

1. 准备新模型版本 #

• 给当前模型新增一个版本（比如Model_v3），设置为当前活跃模型
• 在新模型里，把Maple实体的Parent Entity从Tree改成None
• 把Tree实体里的所有属性（包括height）完全复制到Maple实体里，确保属性的名字、类型、可选性、默认值都和原父实体一致

2. 创建手动映射模型 #

因为移除继承属于结构变更，自动迁移可能不稳定，建议手动控制映射：

• 从旧模型版本到新模型版本创建映射模型（步骤同上）
• 针对Maple实体的映射：
  • 源实体选择旧版本的Maple
  • 目标实体选择新版本的Maple
  • 手动映射每个属性：比如把源实体继承来的height（会显示在源属性列表里）映射到目标实体的height属性
• 保存映射模型，确保所有属性都正确映射

3. 测试迁移兼容性 #

• 用旧版本的数据库文件（比如从用户设备导出的测试数据）测试迁移流程
• 验证迁移后Maple实体的所有属性（包括原继承的height）数据是否完整
• 重点测试iOS14系统的设备，确保没有崩溃或数据丢失

4. 后续清理（可选） #

如果Tree实体不再被其他子实体使用，可以在后续的模型版本中移除它，但要确保所有依赖Tree的数据都已经完成迁移。

内容的提问来源于stack exchange，提问作者Nataliia.dev