近日，一段关于“Realm 数据库迁移块（migration block）内直接赋值对象值是否可行”的开发者讨论在技术社区引发关注。随着移动端数据持久化方案日趋成熟，Realm 作为跨平台对象数据库，其迁移机制一直是开发者高频接触的痛点。本文将从官方文档、实际代码实践及常见陷阱三方面展开分析，为读者提供清晰的技术指引。

问题回溯：迁移块的“直接赋值”质疑

用户最初在 Stack Overflow 及 GitHub Issues 中提出：“Is it possible to assign object value directly in Realm migration block?” 其核心疑惑在于：在 Realm.Configuration(schemaVersion: migrationBlock:) 中，通常使用 migration.enumerateObjects(ofType:) 遍历旧版对象，并通过 newObject 或旧对象指针修改属性。但能否跳过遍历，直接构造一个新对象并赋值？例如：

let newObj = MyRealmObject()
newObj.name = "新值"
migration.create(MyRealmObject.className(), value: newObj)

这种写法在部分场景下被开发者尝试，但往往导致运行时崩溃或数据丢失。

官方机制解析：迁移块内对象的生命周期

要回答这个问题，需先理解 Realm 迁移块的执行模型。迁移块是在数据库版本升级时自动调用的闭包，其内部操作发生在“写事务”中，且此时 旧版 schema 对象已被暂时冻结。官方文档明确指出：

在迁移块中，不应使用常规的 realm.add()、realm.create() 或直接通过初始化器创建对象，因为这些方法依赖当前 schema 版本，而迁移块主要操作的是旧版 schema 下的对象。

正确做法是使用 migration.create(_:value:) 和 migration.delete(_:) 等专用方法。对于 直接赋值 这一问题，需要区分两种情形：

情形一：修改现有对象属性（可行）

假设版本 1 中有一个 Person 对象，版本 2 新增了 fullName 属性。可以通过 enumerateObjects 获取旧对象，然后直接赋值：

migration.enumerateObjects(ofType: Person.className()) { oldObject, newObject in
    newObject!["fullName"] = "\(oldObject!["firstName"]!) \(oldObject!["lastName"]!)"
}

这里 newObject["fullName"] = ... 就是直接属性赋值，完全合法。

情形二：创建新对象并赋值（需谨慎）

用户尝试的“直接构造对象再赋值”属于危险操作。例如：

let newPerson = Person() // ❌ 在迁移块内直接初始化会崩溃
newPerson.name = "张三"
migration.create(Person.className(), value: newPerson)

原因：迁移块执行时，Person 类可能尚未完成 schema 迁移，直接初始化会触发不存在的属性映射。正确的做法是使用 migration.create 的字典参数或直接传递属性列表：

migration.create(Person.className(), value: ["name": "张三", "age": 25]) // ✅

或者通过 newObject 指针在 enumerateObjects 内进行赋值，并配合 migration.create 来完成。

社区实践与常见陷阱

资深 iOS 开发者、Realm 贡献者 Alex 在技术博客中指出，许多新手误以为迁移块内的对象操作与普通 Realm 实例一致，从而掉入以下陷阱：

  1. 忽略属性的动态访问：newObject["property"] 必须使用字符串键路径，不能直接使用点语法（如 newObject.name），因为 newObject 是 DynamicObject 类型。
  2. 忘记处理旧属性重命名：若旧属性名变更，应使用 migration.renameProperty(onType:from:to:)，而非直接赋值。
  3. 赋值的类型不匹配：Realm 不支持隐式类型转换，例如将 Int 赋值给 String? 属性会导致异常。

结论：直接赋值可行但有严格前置条件

综合官方文档与社区经验，可以给出明确答案：在 Realm 迁移块中，直接赋值对象属性是完全可行的，前提是必须通过 newObject 或 oldObject 的动态下标进行，且不能直接使用初始化器构造对象。对于创建新对象，应使用 migration.create(_:value:) 并传入字典或属性数组。

Realm 团队在 2023 年发布的 10.45 版本中进一步优化了迁移 API，新增了 migration.updateObject(ofType: primitiveKey: update:) 方法，使修改特定对象更加简洁，但底层依然遵循上述规则。

对于正在迁移至新 schema 的团队，建议遵循“遍历 + 动态赋值”模式，并在单元测试中覆盖迁移场景。数据迁移是数据库安全的基石，任何“捷径”都可能埋下数据不一致的隐患。开发者应阅读官方《Object Schema & Migrations》指南，结合 RLMRealmMigration 日志进行验证，确保迁移块稳健运行。