运行Corda Flow时出现No transaction in context错误的解决方法

这个错误我在Corda开发中踩过好几次坑，本质就是你的代码尝试在没有活跃事务上下文的环境里执行需要事务支持的操作——比如创建/更新/验证状态、调用Vault服务的某些敏感方法。下面是几个最常见的原因和对应的解决办法：

1. 直接在Flow顶级代码操作状态，未包裹在事务流程中 #

很多新手会犯这个错：直接创建或修改状态，然后试图保存，完全跳过了Corda的事务构建流程。比如：

// 错误示例：无事务上下文直接操作状态
val newState = MyState(ourIdentity, otherParty, 100)
serviceHub.vaultService.save(newState) // 这里会触发错误

Corda要求所有状态变更必须通过合法的事务来完成，正确的做法是构建事务、添加状态和命令、签名并提交：

// 正确示例：完整的事务流程
val notary = serviceHub.networkMapCache.notaryIdentities.first()
val txBuilder = TransactionBuilder(notary)
    .addOutputState(newState, MY_CONTRACT_ID)
    .addCommand(MyContract.Commands.Create(), ourIdentity.owningKey)

// 验证事务并签名
val signedTx = serviceHub.signInitialTransaction(txBuilder)
// 如果需要多方签名，收集其他节点签名
val fullySignedTx = subFlow(CollectSignaturesFlow(signedTx, listOf(otherPartySession)))
// 提交事务到网络
subFlow(FinalityFlow(fullySignedTx, listOf(otherPartySession)))

2. 工具类/Helper方法在无事务上下文被调用 #

如果你把状态操作逻辑抽成了Helper方法，但调用这个方法时，当前代码并不在活跃的事务中，也会触发这个错误：

// 错误示例：Helper方法在无事务环境被调用
fun updateState(oldState: MyState): MyState {
    val updatedState = oldState.copy(amount = oldState.amount + 50)
    serviceHub.vaultService.save(updatedState) // 报错
    return updatedState
}

解决办法：要么把Helper方法的逻辑迁移到事务构建的代码块内部，要么确保调用Helper方法的代码本身处于活跃的事务上下文里（比如在FinalityFlow之前的事务准备阶段）。

3. 误用Vault服务的修改方法 #

注意：serviceHub.vaultService.save()这类方法大多是Corda内部使用的，不应该在业务代码里直接调用。状态的持久化必须通过提交合法的事务来完成，直接调用这些方法会绕过Corda的事务校验，同时触发无上下文错误。

4. 在异步回调/非同步流程中操作状态 #

如果在Flow里使用了异步操作（比如async），并在回调里尝试处理状态，此时事务上下文已经失效，也会报错：

// 错误示例：异步回调中无事务上下文
async {
    val fetchedState = serviceHub.vaultService.queryBy(MyState::class.java).states.first().state.data
    val updated = fetchedState.copy(amount = 200)
    serviceHub.vaultService.save(updated) // 报错
}

解决办法：所有需要事务支持的操作必须放在Flow的同步执行流程中，并且处于事务构建或提交的代码块范围内。

小技巧 #

如果不确定当前是否有活跃事务上下文，可以在代码中通过serviceHub.transactionContext检查——如果返回null，说明当前没有可用的事务上下文。

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