在URLSession后台下载回调中更新RealmSwift对象遇异常求助

这个问题的核心其实是踩中了Realm最基础也最容易被忽略的线程绑定规则，结合URLSession回调的队列特性，才导致你切换队列也没解决问题。我来一步步拆解：

为什么会抛出异常？ #

Realm的核心规则是：所有Realm实例、Realm对象（包括Results、List这类集合）都是线程绑定的——简单说就是，你在哪个线程创建/获取的Realm对象，就只能在哪个线程操作它，跨线程直接访问必然会抛出异常。

而URLSession的didFinishDownloadingTo回调默认运行在系统管理的后台串行队列中，这个队列的线程是复用的，但关键是：如果你用来更新的Realm对象是在其他线程（比如主线程）创建的，哪怕你把更新操作切到主队列/另一个后台队列，只要你没在当前操作的线程重新获取对象，就会触发跨线程访问的错误。

你说切换队列也没用，大概率是因为你只是把更新操作挪到了新队列，但依然在使用之前线程创建的Realm对象引用。

正确的解决思路 #

要解决这个问题，核心就是在回调的当前线程（或你切换后的目标线程）中，重新获取Realm实例和对应的对象，不要持有跨线程的Realm对象引用。具体步骤：

1. 确保你有一个唯一标识可以定位到要更新的Realm对象（比如下载任务的taskIdentifier，或者你自己给下载对象设置的主键）；
2. 在回调队列（或你切换后的队列）里，重新初始化Realm实例；
3. 通过唯一标识查找对应的对象，在Realm的写入事务中完成更新。

代码示例 #

假设你的Realm对象是这样定义的：

class DownloadStatus: Object {
    @objc dynamic var taskId = ""
    @objc dynamic var progress: Float = 0.0
    @objc dynamic var isCompleted = false
    @objc dynamic var localURL: String?
    
    override static func primaryKey() -> String? {
        return "taskId"
    }
}

那在didFinishDownloadingTo回调里的正确写法应该是：

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
    // 用下载任务的taskIdentifier作为主键标识
    let taskId = String(downloadTask.taskIdentifier)
    
    // 在当前回调队列中，重新获取Realm实例并执行更新
    do {
        let realm = try Realm()
        try realm.write {
            // 通过主键查找对象，确保是当前线程的实例
            if let downloadStatus = realm.object(ofType: DownloadStatus.self, forPrimaryKey: taskId) {
                downloadStatus.progress = 1.0
                downloadStatus.isCompleted = true
                downloadStatus.localURL = location.path
            }
        }
    } catch {
        print("更新下载状态失败：\(error.localizedDescription)")
    }
}

额外注意事项 #

• 如果你的回调会频繁触发（比如下载进度更新，不过你这里是didFinishDownloadingTo，是完成时的回调，但如果是进度回调同理），可以考虑把写入操作串行化，避免多个回调同时触发写事务导致等待：比如创建一个专用的串行队列，所有Realm写入操作都放到这个队列里执行。
• 不要尝试跨线程传递Realm对象，哪怕是通过闭包捕获也不行——如果需要传递数据，应该传递对象的主键或者原始数据，在目标线程重新获取对象。
• 如果你一定要切换到主队列更新（比如更新UI同时更新Realm），也要在主队列里重新获取Realm实例和对象，而不是用后台线程的对象。

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