能否将UIKit/Realm应用的数据迁移至SwiftUI/Realm应用？

核心问题原因 #

你的新SwiftUI应用默认使用Schema版本0，但旧UIKit应用的Realm文件已经是版本5，直接访问会触发版本过低的错误。即便添加了迁移块，若未正确设置当前应用的Schema版本，迁移逻辑也不会生效。

正确迁移配置步骤 #

1. 明确设置当前Schema版本 #

在SwiftUI的入口文件（@main修饰的结构体）中，初始化Realm配置时，必须将schemaVersion设为5（与旧应用版本一致；若新应用修改了模型，则设为更高版本，比如6）。

2. 正确配置迁移块 #

确保迁移块在Realm首次访问前完成设置，通常放在App结构体的init方法中：

import SwiftUI
import RealmSwift

@main
struct YourAppName: App {
    init() {
        let config = Realm.Configuration(
            // 必须设置为不低于旧应用的版本号5
            schemaVersion: 5,
            // 迁移块：仅当新版本高于旧版本时触发
            migrationBlock: { migration, oldSchemaVersion in
                // 当前版本与旧版本一致，无需写迁移逻辑
                // 若后续修改模型（比如版本升为6），再在这里处理：
                // if oldSchemaVersion < 6 {
                //     // 处理模型变化，如新增字段、重命名属性等
                // }
            }
        )
        // 将配置设为全局默认
        Realm.Configuration.defaultConfiguration = config
        
        // 提前初始化Realm，避免后续延迟或配置失效
        do {
            _ = try Realm()
        } catch {
            print("Realm初始化失败: \(error)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

3. 验证模型文件一致性 #

确保新SwiftUI应用的Realm模型与旧UIKit应用的模型完全匹配：

• 类名、属性名、属性类型必须完全一致
• @Persisted的配置（主键、索引、可选性）要对应旧模型的@objc dynamic配置，比如旧模型的@objc dynamic var id = UUID().uuidString，新模型需写成@Persisted(primaryKey: true) var id = UUID().uuidString

4. 检查Realm文件路径 #

默认情况下，UIKit和SwiftUI应用的Realm文件路径一致（均在应用Documents目录下），若旧应用使用了自定义路径，新应用需配置相同路径：

// 自定义路径示例
let fileURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0].appendingPathComponent("MyCustomRealm.realm")
let config = Realm.Configuration(fileURL: fileURL, schemaVersion: 5, migrationBlock: { ... })

常见错误排查 #

• 不要将deleteRealmIfMigrationNeeded设为true，这会直接删除旧数据，导致迁移失效
• 确保迁移块在任何Realm实例创建前设置，否则配置不会生效
• 若新应用修改了模型结构，需将schemaVersion设为高于5的版本，并在迁移块中处理变化（比如给新字段设置默认值）

迁移可行性确认 #

完全可行，只要满足：

• 新应用的Bundle ID和签名配置与旧应用完全一致
• Realm配置正确设置了Schema版本和迁移逻辑
• 模型结构匹配（或通过迁移块处理差异）

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