.Net Realm断言失败：!realm.is_in_transaction()，如何启用回溯？

问题分析 #

你遇到的崩溃来自Realm Core的断言失败：Assertion failed: !realm.is_in_transaction()，说明某个Realm实例在存在未提交事务的状态下，触发了Coordinator的清理或销毁逻辑。即使你确保所有变更都在realm.Write块中，仍可能存在异步事务未正确等待、测试并行冲突、实例未妥善销毁等隐性问题。

开启回溯功能排查步骤 #

针对.NET 8 + Realm 11.6.1，可通过以下两种方式开启调试回溯，获取崩溃时的详细调用栈：

1. 环境变量方式（全局生效） #

在测试运行前设置环境变量，让所有Realm实例生成回溯信息：

• Windows：在命令行运行测试前执行

  set REALM_DEBUG_BACKTRACE=1 && dotnet test
  

  若使用Visual Studio，可在测试项目的「属性→调试→环境变量」中添加REALM_DEBUG_BACKTRACE=1。
• Linux/macOS：

  export REALM_DEBUG_BACKTRACE=1 && dotnet test
  

2. 代码配置方式（针对特定Realm实例） #

在测试初始化或创建Realm实例的代码中，显式开启回溯：

[TestInitialize]
public void SetupTest()
{
    var config = new RealmConfiguration("test.realm")
    {
        EnableDebugBacktrace = true
    };
    // 确保测试中使用的Realm实例都基于此配置创建
    _realm = Realm.GetInstance(config);
}

开启后，再次触发崩溃时会输出完整的调用栈，帮你定位到具体哪个操作导致事务未提交。

额外排查方向 #

• 检查异步事务：若使用realm.WriteAsync()，需确保所有异步操作都已正确await，避免事务未完成就销毁Realm实例。
• 测试并行性：Realm实例并非线程安全，若测试并行运行，需保证每个测试线程使用独立的Realm实例，或禁用测试并行。
• 实例销毁逻辑：测试结束时需调用realm.Dispose()，且确保在事务完全提交后再执行销毁操作。
• 版本兼容性：可尝试升级Realm到11.x系列的最新补丁版本，或查看官方变更日志确认是否有相关断言失败的修复。

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