SwiftData自定义迁移持续失败——疑似框架Bug

我在SwiftUI iOS应用中使用SwiftData，需要在上线前实现MigrationPlan，确保后续修改存储数据模型时能平稳过渡。比如未配置迁移时，将属性类型从Bool改为[Bool]会导致应用加载SwiftData时崩溃。

当前配置 #

现有@Model类MyData包含多属性及初始化方法，ModelContainer初始化代码如下：

@Model
final class MyData
{
    var property1: Bool = true
    var property2: Bool = true
    var property3: Int = 1
    // 更多属性...
    // 默认与动态构造器...
}

var sharedModelContainer: ModelContainer =
{
    let schema = Schema([MyData.self])
    let modelConfiguration = ModelConfiguration(schema: schema, isStoredInMemoryOnly: false)
    do {
        return try ModelContainer(for: schema, configurations: [modelConfiguration])
    } catch {
        fatalError("Could not create ModelContainer: \(error)")
    }
}()

@main
struct myApp: App {
    var body: some Scene {
        WindowGroup { ContentView() }
        .modelContainer(sharedModelContainer)
    }
}

迁移尝试 #

• 将原模型重命名为MyDataV1，定义MyDataV2并修改property1为[Bool]类型，添加迁移构造器
• 通过typealias MyData = MyDataV2保持应用其他部分引用一致
• 定义MyDataSchemaV1、MyDataSchemaV2两个VersionedSchema实例
• 实现MyDataMigrationPlan处理V1到V2的自定义迁移
• 更新ModelContainer初始化引入迁移计划

迁移错误 #

当已有MyDataV1实例存储时，启动新版本应用，willMigrate执行无错，但didMigrate启动前出现CoreData与CloudKit相关报错导致崩溃。

已尝试的解决方案 #

• 移除willMigrate中删除模型的代码，仍报错
• 在V2 Schema中加入V1模型，出现“无法使用阶段迁移，协调器模型版本未知”错误
• 在ModelContainer中同时加入V1和V2模型，willMigrate执行后仍因CloudKit镜像代理初始化失败崩溃

最终结论 #

苹果DTS工程师确认这些错误为框架Bug，SwiftData结合CloudKit同步时迁移功能失效。建议向苹果提交反馈，设计无需迁移的模型，或转回使用CoreData。

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