Corda测试抛出IllegalStateException：发现未预期的数据库事务

当你在Corda单元测试的setup方法中初始化MockNetwork时遇到java.lang.IllegalStateException，提示当前线程存在未预期的现有数据库事务，这是测试线程中残留的未清理事务上下文干扰了MockNetwork的数据库初始化流程导致的。下面是具体的分析和解决办法：

可能的诱因 #

• 测试类或其父类使用了外部事务管理注解（比如Spring的@Transactional），与Corda自身的事务机制产生冲突
• 前序测试执行后没有彻底关闭MockNetwork，导致线程上下文残留未清理的事务
• 测试框架的隔离级别配置不当，多个测试共享了同一个线程上下文

具体解决方案 #

1. 移除不必要的事务注解 #

如果你的测试类标注了@Transactional这类外部事务注解，直接删除它——Corda的MockNetwork会自行处理节点的数据库事务，外部事务注解会打乱这个流程：

// 错误写法
@Transactional
class FlowUnitTests {
    // ...
}

// 正确写法
class FlowUnitTests {
    // ...
}

2. 确保MockNetwork的完整清理 #

在测试的teardown方法中，必须彻底关闭MockNetwork并清理线程本地的事务上下文：

private lateinit var mockNetwork: MockNetwork

@Before
fun setup() {
    mockNetwork = MockNetwork(MockNetworkParameters(cordappsForAllNodes = listOf(...)))
    // 其他初始化逻辑
}

@After
fun teardown() {
    // 停止所有节点并关闭网络
    mockNetwork.stopNodes()
    mockNetwork.close()
    // 手动清理线程本地存储的事务
    net.corda.nodeapi.internal.persistence.DatabaseTransaction.current.set(null)
}

3. 调整MockNetwork的事务模式配置 #

初始化MockNetwork时，指定使用本地事务模式，避免共享事务上下文：

val mockNetwork = MockNetwork(MockNetworkParameters(
    cordappsForAllNodes = listOf(...),
    databaseTransactionMode = DatabaseTransactionMode.LOCAL_TRANSACTIONS
))

4. 配置测试框架的隔离级别 #

确保每个测试方法都运行在独立的上下文环境中。如果使用JUnit 4，可以这样配置：

@RunWith(JUnit4::class)
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class FlowUnitTests {
    // ...
}

如果是JUnit 5，默认就是PER_METHOD隔离级别，若被修改过，恢复默认配置即可。

5. 手动清理前置事务（兜底方案） #

如果以上方法都无效，在初始化MockNetwork前手动检查并清理当前线程的事务：

@Before
fun setup() {
    // 清理残留的事务上下文
    val currentTx = net.corda.nodeapi.internal.persistence.DatabaseTransaction.current.get()
    if (currentTx != null) {
        currentTx.close()
        net.corda.nodeapi.internal.persistence.DatabaseTransaction.current.set(null)
    }
    // 初始化MockNetwork
    mockNetwork = MockNetwork(...)
}

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