SwiftData自定义SchemaMigrationPlan未执行问题排查求助

问题核心 #

你是从Core Data存储直接迁移到SwiftData，但当前的迁移计划仅针对SwiftData内部版本设计，SwiftData并未触发从Core Data到SchemaV1的迁移流程，而是直接以默认值创建新的SwiftData存储，完全跳过了自定义映射逻辑。

具体修复步骤 #

1. 让SwiftData识别Core Data源存储 #

SwiftData从Core Data迁移时，必须明确告知它原始Core Data的模型信息：

• 保留原项目中的Core Data .xcdatamodeld 文件
• 在迁移计划中添加从Core Data模型到SchemaV1的自定义迁移阶段

修改迁移计划代码：

// 先加载Core Data的模型文件
private static let coreDataModel = NSManagedObjectModel(contentsOf: Bundle.main.url(forResource: "MyApp", withExtension: "momd")!)!

// 添加Core Data到SchemaV1的迁移阶段
static let migrateCoreDataToV1 = MigrationStage.custom(
    fromVersion: coreDataModel,
    toVersion: SchemaV1.self,
    willMigrate: nil,
    didMigrate: { context in
        print("开始从Core Data迁移到SchemaV1")
        // 可在此补充Core Data到SchemaV1的基础数据映射逻辑
    }
)

// 更新迁移阶段顺序
static var stages: [MigrationStage] {
    [migrateCoreDataToV1, migrateV1toV2Step1, migrateV1toV2Step2]
}

2. 修复自定义迁移中的错误隐藏问题 #

你当前的didMigrate闭包使用try?会掩盖fetch、save操作的错误，导致无法排查迁移失败原因，改为do-catch明确捕获错误：

static let migrateV1toV2Step1 = MigrationStage.custom(
    fromVersion: SchemaV1.self,
    toVersion: SchemaV2Step1.self,
    willMigrate: nil,
    didMigrate: { context in
        print("Start migrating Core Data to SwiftData")
        do {
            let loans = try context.fetch(FetchDescriptor<SchemaV2Step1.Loan>())
            loans.forEach { loan in
                loan.amount = Decimal(loan.price ?? 0.0)
                // 其他自定义映射逻辑
            }
            try context.save()
        } catch {
            print("迁移出错：\(error)")
        }
    })

3. 确保最终Schema与目标版本完全匹配 #

检查finalSchema的实体、属性定义，必须和SchemaV2Step2完全一致，否则SwiftData会跳过迁移流程直接创建新存储。

4. 验证存储元数据（可选） #

在MyApp的init方法中添加元数据打印，确认SwiftData是否正确识别原始存储版本：

init() {
    let dataUrl = URL.applicationSupportDirectory.appending(path: "MyApp.sqlite")
    if let metadata = try? NSPersistentStoreCoordinator.metadataForPersistentStore(ofType: NSSQLiteStoreType, at: dataUrl, options: nil) {
        print("当前存储元数据：\(metadata)")
        print("SchemaV1元数据：\(SchemaV1.metadata)")
        print("Core Data模型元数据：\(Self.coreDataModel.entityVersionHashesByName)")
    }
    
    // ... 原有容器初始化代码
}

5. 测试环境注意事项 #

测试迁移时，不要每次运行都删除应用数据——否则SwiftData会直接创建新存储，不会触发迁移逻辑。

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