首次运行Kotlin版cordapp-example，IntelliJ报NodeDriverKt类未找到求助

这种情况在Kotlin+Corda项目里很常见，核心原因是Kotlin的顶层函数编译规则：当你在NodeDriver.kt里写了没有类包裹的顶层main函数时，Kotlin编译器会自动生成一个名为NodeDriverKt的类来容纳这些顶层函数，而IDE或项目配置的小问题可能导致找不到这个自动生成的类。下面是一步步的解决办法：

• 第一步：确保项目完成完整编译
  这个自动生成的NodeDriverKt类是编译阶段才会产出的，所以先执行项目的编译任务：

  • 在IntelliJ右侧的Gradle面板中，找到项目根目录下的Tasks -> build -> build，双击运行；
  • 或者在终端执行命令：./gradlew build（Windows系统用gradlew.bat build）。
    如果编译过程中出现其他错误（比如依赖缺失、语法问题），先把这些错误解决掉，再重新尝试运行。

• 第二步：清理IntelliJ缓存并重启IDE
  IDE缓存失效是这类“明明文件存在却找不到类”问题的高发原因：

  1. 点击顶部菜单栏的File -> Invalidate Caches...；
  2. 在弹出的窗口中选择Invalidate and Restart，等待IDE重启完成后再尝试运行项目。

• 第三步：检查文件目录和Kotlin配置
  确认NodeDriver.kt所在的目录被标记为Sources Root（蓝色文件夹图标）：

  • 如果不是，右键该目录，选择Mark Directory as -> Sources Root。
    同时检查项目的Kotlin配置：
  1. 点击File -> Project Structure -> Modules；
  2. 查看对应模块的Kotlin facet，确保Kotlin版本和项目依赖的版本一致，没有配置错误。

• 第四步：修正运行配置的主类
  如果你是通过Run/Debug Configuration启动项目的，一定要确认配置里的Main class填写的是com.example.NodeDriverKt（注意末尾的Kt后缀），而不是com.example.NodeDriver——因为顶层main函数属于这个自动生成的NodeDriverKt类，填错就会报找不到类的错误。

• 第五步：检查Gradle配置的正确性
  确认项目的build.gradle（或build.gradle.kts）里正确引入了Kotlin插件，并且sourceSets配置正确：
  比如Groovy版的build.gradle应该包含：

  plugins {
      id 'org.jetbrains.kotlin.jvm' version '1.9.20' // 版本号和项目保持一致
  }
  
  sourceSets {
      main {
          kotlin {
              srcDirs 'src/main/kotlin'
          }
      }
  }
  

按照上面的步骤逐一排查，基本就能解决这个找不到类的问题了。

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