Spring Boot中使用suspend函数遇ClassNotFoundException问题求助

核心原因 #

这个错误本质是kotlinx-coroutines-reactor依赖未正确引入或版本不兼容，你提到的“reactor没有jvm版本”是误解——这个库本身就是专为JVM平台开发的，不需要额外指定jvm分类；而kotlinx-coroutines-core有jvm版本是因为它同时支持JS、Native等多平台。

具体解决步骤 #

• 统一协程依赖版本：确保kotlinx-coroutines-core和kotlinx-coroutines-reactor版本完全一致，并且和你的Kotlin、Spring Boot版本匹配。比如Kotlin 1.9.x对应协程1.7.x，Spring Boot 3.x建议搭配Kotlin 1.8+。
  直接在Maven的pom.xml里添加以下依赖（版本可根据你的Kotlin版本调整）：

  <dependencies>
      <!-- Kotlin协程核心 -->
      <dependency>
          <groupId>org.jetbrains.kotlinx</groupId>
          <artifactId>kotlinx-coroutines-core</artifactId>
          <version>1.7.3</version>
          <scope>runtime</scope>
      </dependency>
      <!-- 协程与Reactor集成 -->
      <dependency>
          <groupId>org.jetbrains.kotlinx</groupId>
          <artifactId>kotlinx-coroutines-reactor</artifactId>
          <version>1.7.3</version>
          <scope>runtime</scope>
      </dependency>
  </dependencies>
  

  更推荐用Spring Boot的依赖管理自动对齐版本，只需声明依赖无需指定版本：

  <dependencyManagement>
      <dependencies>
          <dependency>
              <groupId>org.springframework.boot</groupId>
              <artifactId>spring-boot-dependencies</artifactId>
              <version>${spring-boot.version}</version>
              <type>pom</type>
              <scope>import</scope>
          </dependency>
      </dependencies>
  </dependencyManagement>
  
  <dependencies>
      <dependency>
          <groupId>org.jetbrains.kotlinx</groupId>
          <artifactId>kotlinx-coroutines-core</artifactId>
      </dependency>
      <dependency>
          <groupId>org.jetbrains.kotlinx</groupId>
          <artifactId>kotlinx-coroutines-reactor</artifactId>
      </dependency>
  </dependencies>
  

• 清理Maven缓存并重新构建：有时候本地仓库的依赖缓存损坏，执行以下命令强制更新依赖：

  mvn clean install -U
  

• 检查Spring Boot与Kotlin版本兼容性：比如Spring Boot 2.7.x建议搭配Kotlin 1.6-1.7，Spring Boot 3.x要求Kotlin 1.8+，版本不匹配会导致协程集成类加载失败。

• 确认控制器写法正确：suspend端点的写法要符合Spring WebFlux要求，示例：

  @RestController
  class TestController {
      @GetMapping("/test")
      suspend fun testEndpoint(): String {
          // 调用其他suspend函数逻辑
          return "success"
      }
  }
  

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