Swift 4下iOS使用Realm启动崩溃：Book对象不存在主键'serial'

我之前在Swift 4迁移Realm的项目里碰到过几乎一模一样的坑，给你几个针对性的排查和解决步骤：

1. 确保模型属性的修饰符符合Swift 4要求 #

Swift 4开始，Realm需要依赖OC运行时来识别模型属性，如果你给Book类的serial主键只加了dynamic没加@objc，或者属性是private的，Realm就会识别不到这个属性，直接抛出Primary key property 'serial' does not exist的异常。

正确的模型写法应该是这样：

import RealmSwift

class Book: Object {
    // 必须用@objc dynamic修饰，确保Realm能识别
    @objc dynamic var serial: String = ""
    // 其他属性也要按这个规则来
    @objc dynamic var title: String = ""

    override static func primaryKey() -> String? {
        return "serial"
    }
}

2. 补全Realm迁移逻辑（关键！） #

你是从旧版本迁移到Swift 4，大概率是旧的Realm数据库里没有serial这个主键字段，直接加主键会导致Realm无法自动兼容旧数据，进而引发崩溃和数据异常（就是你看到的只有序号没有实际数据的情况）。

必须在App启动时添加迁移配置，给旧数据补全主键值：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 配置Realm迁移
    let config = Realm.Configuration(
        // 版本号要比之前的schemaVersion高（比如之前是0，现在设为1）
        schemaVersion: 1,
        migrationBlock: { migration, oldSchemaVersion in
            // 处理旧版本数据
            if oldSchemaVersion < 1 {
                // 遍历所有旧的Book对象，给serial字段赋值唯一值
                migration.enumerateObjects(ofType: Book.className()) { oldObj, newObj in
                    // 可以用UUID生成唯一主键，或者根据旧数据的其他字段拼接
                    newObj!["serial"] = UUID().uuidString
                }
            }
        })
    
    // 设置为默认配置
    Realm.Configuration.defaultConfiguration = config
    
    // 提前初始化Realm触发迁移，避免启动时崩溃
    do {
        _ = try Realm()
    } catch {
        print("Realm迁移失败：\(error.localizedDescription)")
    }
    
    return true
}

3. 排查注释主键后无法存储数据的问题 #

注释主键后能运行但存不了数据，大概率是模型属性没有正确修饰（比如没加@objc dynamic），或者写入逻辑有错误。

检查你的写入代码是否正确捕获了异常：

// 正确的写入示例
do {
    let realm = try Realm()
    try realm.write {
        let newBook = Book()
        newBook.title = "Swift从入门到精通"
        // 如果主键没注释，这里要设置serial的值
        // newBook.serial = "book_001"
        realm.add(newBook)
    }
} catch {
    print("写入Realm失败：\(error)")
}

如果属性没加@objc dynamic，Realm无法监听属性变化，自然也无法持久化对象。

4. 临时排查：清除旧的Realm文件 #

如果上面的步骤都试过还是有问题，可以先删除设备/模拟器上的App，清除旧的Realm数据库文件，然后重新运行。如果此时能正常启动和存储数据，说明问题确实出在旧数据的迁移上，需要再细化迁移逻辑。

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