Realm Swift 在 Xcode 16 中的异步写入编译问题解析

2025-05-13 20:42:30作者：傅爽业Veleda

在 macOS 15 和 Xcode 16 环境下，开发者使用 Realm Swift 的 asyncWrite 方法时遇到了编译错误。这一问题主要源于 Swift 6 编译器对并发模型的严格检查，导致原本在早期版本中能正常运行的代码现在无法通过编译。

问题现象

开发者尝试在异步上下文中使用 asyncWrite 方法时，Xcode 16 会抛出编译错误。典型的错误场景如下：

func asyncDeleteAllDevices(config: Realm.Configuration) async throws {
    let realm = try await Realm(configuration: config)
    
    try await realm.asyncWrite {
        let allDevices = realm.objects(Device.self)
        realm.delete(allDevices)
    }
}

根本原因

这个问题实际上是 Swift 6 编译器对并发安全性的增强检查所致。在 Swift 6 中：

asyncWrite 方法要求必须在 actor 隔离的上下文中调用
try await Realm() 初始化同样需要 actor 隔离
非隔离的异步函数无法直接调用这些方法

在 Swift 5 及更早版本中，编译器不会强制执行这些检查，可能导致运行时问题。Swift 6 通过编译时错误来防止潜在的并发安全问题。

解决方案

开发者可以采用以下几种方式解决这个问题：

自定义异步写入扩展：通过实现自己的异步写入逻辑来绕过编译问题：

extension Realm {
    func asyncWrite<T>(_ block: @escaping (Realm) throws -> T) async throws -> T {
        return try await withCheckedThrowingContinuation { continuation in
            DispatchQueue(label: "xx.yy.zz").async {
                do {
                    let realm = try Realm(configuration: self.configuration)
                    try realm.write {
                        let result = try block(realm)
                        continuation.resume(returning: result)
                    }
                } catch {
                    continuation.resume(throwing: error)
                }
            }
        }
    }
}

使用全局 Actor：创建一个专门的 DatabaseActor 来管理 Realm 操作：

@globalActor actor DatabaseActor: GlobalActor {
    static var shared = DatabaseActor()
}

open class BaseDAO<Model: Object> {
    internal var realm: Realm!
    
    init() async throws {
        realm = try await Realm(actor: DatabaseActor.shared)
    }
    
    func save(_ array: [Model]) async throws {
        try await self.realm.asyncWrite(_isolation: DatabaseActor.shared) { [weak self] in
            self?.realm.add(array, update: .all)
        }
    }
}