Corda V2：NodeDriver本地网络运行Flow时Corda服务不存在的解决方法

我来帮你一步步排查和解决这个问题，你遇到的java.lang.IllegalArgumentException: Corda service com.example.services.MyService does not exist异常，通常是因为服务的注册、加载或者配置环节有遗漏，下面是具体的修复步骤：

1. 确保自定义服务正确标记并实现 #

首先检查你的MyService类是否符合Corda Service的要求：

• 必须添加@CordaService注解（来自net.corda.v5.application.service包）
• 类需要是public访问修饰符
• 正确注入AppServiceHub作为构造参数，并且继承SingletonSerializeAsToken（Corda V2中要求服务是可序列化的单例）

示例代码：

import net.corda.v5.application.service.CordaService
import net.corda.v5.base.types.SingletonSerializeAsToken
import net.corda.v5.application.services.AppServiceHub

@CordaService
class MyService(private val services: AppServiceHub) : SingletonSerializeAsToken() {
    // 你的服务业务方法，比如：
    fun doSomething(): String {
        return "Service executed successfully"
    }
}

2. 配置SPI文件让Corda识别服务 #

Corda通过SPI（服务提供者接口）机制加载自定义服务，你需要在Cordapp的resources/META-INF/services目录下创建一个名为net.corda.v5.application.service.CordaService的文件，文件内容是你的服务全类名：

com.example.services.MyService

如果这个文件不存在，Node（包括NodeDriver启动的本地节点）根本找不到你的服务，这是很多开发者容易忽略的关键点。

3. 完善NodeDriver的配置 #

虽然你已经添加了extraCordappPackagesToScan，但还需要确保NodeDriver正确加载包含服务的Cordapp：

• 如果是单模块项目，确认extraCordappPackagesToScan包含了服务所在的包com.example.services
• 如果是多模块项目，需要在启动节点时明确指定加载包含服务的Cordapp模块，示例代码：

import net.corda.testing.driver.DriverParameters
import net.corda.testing.driver.driver
import net.corda.testing.node.User
import net.corda.v5.base.types.CordaX500Name

fun main() {
    driver(
        DriverParameters(
            isDebug = true,
            extraCordappPackagesToScan = listOf("com.example.services")
        )
    ) {
        // 启动节点时明确加载包含MyService的Cordapp
        val partyA = startNode(
            providedName = CordaX500Name("PartyA", "London", "GB"),
            cordapps = listOf(getCordapp("com.example")) // 这里替换为你的Cordapp组ID/模块名
        ).getOrThrow()
        
        // 测试Flow调用
        val result = partyA.rpc.startFlowDynamic(MyFlow::class.java).returnValue.getOrThrow()
        println("Flow result: $result")
    }
}

4. 验证Flow中服务的调用方式 #

确保在Flow中通过serviceHub获取服务，而不是手动实例化：

import net.corda.v5.application.flows.InitiatingFlow
import net.corda.v5.application.flows.FlowLogic
import net.corda.v5.application.services.cordaService

@InitiatingFlow
class MyFlow : FlowLogic<String>() {
    override fun call(): String {
        // 通过serviceHub获取服务实例
        val myService = serviceHub.cordaService(MyService::class.java)
        return myService.doSomething()
    }
}

5. 清理并重新构建项目 #

最后，清理项目缓存并重新构建，避免旧的编译产物导致问题：

• 如果你用Gradle，执行命令：./gradlew clean build
• 如果你用Maven，执行命令：mvn clean install

完成以上步骤后，NodeDriver启动的本地节点应该就能正确识别并加载你的自定义服务，Flow调用时也不会再抛出异常了。

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