为何切换用户登录后出现Multiple Sync Agents与Client Reset Error？

问题根源 #

这个问题源于模板默认未适配多用户切换场景的Realm资源清理逻辑：

• 登出时未关闭旧用户关联的所有Realm实例，导致旧同步代理持续运行
• 新用户登录时尝试复用旧用户的Realm文件，触发User mismatch for client file identifier错误，进而引发自动客户端重置失败和多同步代理冲突崩溃

具体修复步骤 #

1. 登出时强制关闭Realm实例并清理关联文件

修改模板中的登出逻辑，在执行登出前先处理Realm资源的清理：

func logout() async {
    guard let currentUser = app.currentUser else { return }
    
    // 关闭当前用户关联的所有Realm实例
    let realmConfig = currentUser.configuration(partitionValue: "user=\(currentUser.id)")
    Realm.Configuration.openRealms
        .filter { $0.configuration.fileURL == realmConfig.fileURL }
        .forEach { $0.close() }
    
    // 删除当前用户的Realm相关文件（避免残留冲突）
    let fileManager = FileManager.default
    let fileURL = realmConfig.fileURL
    let relatedPaths = [
        fileURL,
        fileURL.appendingPathExtension("lock"),
        fileURL.appendingPathExtension("management")
    ]
    
    for path in relatedPaths {
        try? fileManager.removeItem(at: path)
    }
    
    // 执行登出操作
    do {
        try currentUser.logOut()
    } catch {
        print("登出失败: \(error.localizedDescription)")
    }
}

2. 确保新用户使用专属Realm配置

获取Realm实例时，必须使用当前登录用户的专属配置，禁止复用全局默认配置：

func getRealm() async throws -> Realm {
    guard let user = app.currentUser else {
        throw AppError.notLoggedIn
    }
    let config = user.configuration(partitionValue: "user=\(user.id)")
    return try await Realm(configuration: config)
}

关键说明 #

• ClientFileUserMismatch错误：Realm文件与创建它的用户ID绑定，新用户无法直接打开旧用户的Realm文件，必须先清理旧文件
• MultipleSyncAgents崩溃：未关闭的旧Realm实例会保留同步代理，新用户的同步代理尝试连接同一文件时会触发冲突

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