解决Realm Kotlin Android的[RLM_ERR_WRONG_TRANSACTION_STATE]错误

核心错误原因 #

RLM_ERR_WRONG_TRANSACTION_STATE 错误直接说明你在只读事务（或无事务）环境下尝试修改Realm数据。Realm的所有写操作必须包裹在可写事务中，否则会触发该异常。

正确实现方案 #

你的需求是将选中用户设为当前用户（currentUser = true），其余用户设为非当前用户（currentUser = false），必须保证这两个操作在同一个原子事务中完成，避免数据不一致。以下是两种常见场景的实现代码：

1. 非协程环境（同步操作） #

// 获取Realm实例
val realm = Realm.getDefaultInstance()

try {
    // 开启可写事务
    realm.writeBlocking {
        // 第一步：批量将所有用户的currentUser设为false
        this.query<User>()
            .set("currentUser", false)
            .find()
            .update()
        
        // 第二步：将选中的用户设为currentUser = true
        val selectedUser = this.query<User>("_id == $0", selectedUserId).findFirst()
        selectedUser?.let {
            it.currentUser = true
        }
    }
} finally {
    // 关闭Realm实例
    realm.close()
}

2. 协程环境（异步操作） #

如果在ViewModel或协程场景中，推荐使用suspend版本的事务：

// 在协程作用域内执行
coroutineScope.launch {
    val realm = Realm.getDefaultInstance()
    try {
        realm.write {
            // 批量更新所有用户为非当前用户
            this.query<User>()
                .set("currentUser", false)
                .find()
                .update()
            
            // 更新选中用户
            val selectedUser = this.query<User>("_id == $0", selectedUserId).findFirst()
            selectedUser?.currentUser = true
        }
    } finally {
        realm.close()
    }
}

常见问题排查 #

• 禁止在事务外修改Realm对象：如果之前是先查询用户列表，在事务外修改属性再尝试保存，必然触发错误。所有修改必须在write或writeBlocking块内执行。
• 不要拆分事务：若将“批量设为false”和“选中用户设为true”拆成两个独立事务，可能出现中间状态（短时间内无当前用户），原子事务能保证操作一致性。
• 检查Realm实例状态：确保使用的Realm实例配置为可写，只读配置会导致无法开启写事务。

替代优化方案（高效批量操作） #

若用户数量较多，使用批量更新API比遍历修改更高效：

realm.writeBlocking {
    // 先批量更新所有用户为非当前用户
    this.query<User>().set("currentUser", false).find().update()
    // 再更新选中用户
    this.query<User>("_id == $0", selectedUserId).set("currentUser", true).find().update()
}

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