Realm+SwiftUI下如何正确更新Schema Version？

错误原因 #

你只临时将schemaVersion设为2并打开了Realm，但没有配置迁移闭包，且后续代码（比如SwiftUI的Realm相关组件）仍在使用默认的版本0配置，导致数据库版本已升级到2，但访问时用了更低的版本，触发版本冲突报错。

Realm要求：当schema版本提升时，必须明确配置迁移逻辑（哪怕是自动增量迁移），否则旧版本的配置无法访问已升级的数据库。

正确操作步骤 #

1. 修改数据模型，添加新属性 #

确保新属性是可选类型或带有默认值，这样Realm可以自动完成增量迁移，无需手动修改现有记录：

// 示例：给原有Object类添加新属性
class YourRealmObject: Object {
    // 原有属性
    @Persisted var id: String
    @Persisted var name: String
    
    // 新增属性：可选类型（自动适配现有记录）
    @Persisted var newOptionalProperty: String?
    
    // 或者：带默认值的属性（自动给现有记录赋值默认值）
    // @Persisted var newDefaultProperty: String = ""
}

2. 配置全局Realm默认配置 #

在App启动时（比如App.swift的初始化方法、首页视图的onAppear开头）设置全局默认配置，包含schemaVersion和迁移闭包：

// 配置Realm全局默认设置
let realmConfig = Realm.Configuration(
    schemaVersion: 2, // 设为比原版本0更高的版本号
    migrationBlock: { migration, oldSchemaVersion in
        // 因为是添加可选/带默认值的属性，这里无需写额外逻辑，Realm会自动处理现有记录
        if oldSchemaVersion < 2 {
            // 后续如果有复杂迁移（比如重命名属性、数据转换），再在这里添加逻辑
        }
    }
)

// 将该配置设为默认，所有Realm实例都会使用这个配置
Realm.Configuration.defaultConfiguration = realmConfig

// 初始化Realm触发迁移（如果需要）
do {
    let realm = try Realm()
    print("Realm初始化成功，当前schema版本：\(realm.configuration.schemaVersion)")
} catch {
    print("Realm初始化失败：\(error)")
}

3. 统一所有Realm实例的配置 #

确保代码中所有创建Realm的地方（包括SwiftUI的@ObservedResults、@Query等）都使用全局默认配置，不要单独创建不带schemaVersion的配置。比如查询版本的代码可以简化为：

do {
    let currentVersion = try schemaVersionAtURL(Realm.Configuration.defaultConfiguration.fileURL!)
    print("当前数据库schema版本：\(currentVersion)")
} catch {
    print("查询版本失败：\(error)")
}

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