添加Transformable后SwiftData迁移崩溃问题求助

问题背景 #

在Xcode 15 Beta RC环境下，SwiftData执行从V4到V5版本的Schema迁移时触发崩溃，错误提示：

Persistent store migration failed, missing source managed object model

现有5个Schema版本，涉及Item和Category两个实体：

• V1：初始版本
• V2：轻量迁移，Item属性重命名
• V3：自定义迁移，Item新增两个布尔属性
• V4：自定义迁移，Category新增Transformable类型属性
• V5：自定义迁移，Item新增字符串属性（迁移时崩溃）

V1到V4的迁移均正常执行，仅V4→V5迁移失败，且迁移计划配置无误。已尝试以下操作但未解决问题：

• 确保模型容器仅初始化一次
• 单独验证V1到V4的迁移流程
• 在真机和模拟器上测试
• 删除重装App可正常运行，但无法要求用户执行此操作

排查思路 #

1. 检查V4模型的完整性

   • 确认V4的Schema文件（实体、属性、Transformable类型配置）无损坏或遗漏，尤其注意Category的Transformable属性的类型声明是否正确，且在V5迁移计划中被正确识别。
   • 验证V4的模型文件是否被正确打包进App Bundle，未因编译错误或误删导致缺失。

2. 核对迁移计划的版本映射

   • 检查V4到V5的自定义迁移计划中，是否正确指定了源模型（V4）和目标模型（V5）的版本标识符，避免版本号混淆或映射错误。
   • 确认MigrationPlan的models数组中正确包含了V4的模型实例，无引用遗漏。

3. 排查Transformable属性的迁移兼容性
   V4中新增的Category Transformable属性需重点验证：

   • 该属性的Transformer在V5版本中是否保持实现和标识符一致，未因修改导致迁移时无法解析V4存储的数据。
   • 若为自定义Transformer，确保V4和V5版本中均实现NSSecureCoding，且编码/解码逻辑完全兼容。

4. 验证模型版本的哈希值匹配
   SwiftData通过模型哈希值识别版本，若V4模型哈希值因属性顺序、隐式类型变更等意外变化，会导致系统无法匹配源模型：

   • 对比V4模型编译后产物（.momd目录下的.mom文件）的哈希值，确认与之前正常迁移时的版本一致。
   • 检查是否误编辑了V4版本的Schema文件，导致模型定义变更。

5. 启用详细迁移日志
   在模型容器初始化时添加日志配置，获取迁移失败的具体细节：

   let config = ModelConfiguration(schema: Schema([Item.self, Category.self]), migrationPlan: MyMigrationPlan.self)
   config.loggingLevel = .debug
   let container = try ModelContainer(for: Item.self, Category.self, configurations: config)
   

   通过日志查看系统尝试加载的模型版本，定位找不到V4模型的具体环节。

6. 测试增量迁移路径
   创建仅包含V4数据的测试环境，单独测试V4→V5的迁移流程，排除多步迁移的累积问题。

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