Spring Boot接口序列化Kotlin枚举时出现ClassNotFoundException问题

这个问题我之前也碰到过，核心原因是Kotlin反射依赖缺失——Spring Boot在处理Kotlin类（包括枚举）的序列化时，需要用到kotlin-reflect库完成反射操作，没引入的话就会抛出这个类找不到的错误。下面一步步帮你解决：

1. 优先添加Kotlin反射依赖 #

这是解决问题的关键步骤，根据你的构建工具添加对应的依赖：

Maven 配置 #

在pom.xml中加入：

<dependency>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-reflect</artifactId>
</dependency>

Gradle（Groovy DSL）配置 #

在build.gradle中加入：

implementation "org.jetbrains.kotlin:kotlin-reflect"

Gradle（Kotlin DSL）配置 #

在build.gradle.kts中加入：

implementation("org.jetbrains.kotlin:kotlin-reflect")

注意：Spring Boot父项目已经管理了Kotlin的版本，不需要手动指定版本号，确保版本和项目中其他Kotlin依赖一致即可。

2. 验证Spring Boot与Kotlin版本兼容性 #

版本不匹配也可能引发这类反射相关的异常，你需要确保Spring Boot版本和Kotlin版本是兼容的：

• Spring Boot 3.x 要求Kotlin 1.8及以上版本
• Spring Boot 2.7.x 对应Kotlin 1.6及以上版本
  可以检查项目的依赖管理配置，确认两者版本匹配。

3. 配置Jackson Kotlin模块（优化序列化体验） #

Spring Boot默认使用Jackson处理JSON序列化，引入jackson-module-kotlin可以让Jackson更好地支持Kotlin类的序列化/反序列化，包括枚举：

添加依赖 #

Maven：

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-kotlin</artifactId>
</dependency>

Gradle：

implementation "com.fasterxml.jackson.module:jackson-module-kotlin"

注册Kotlin模块 #

可以通过配置类让ObjectMapper自动注册Kotlin模块：

import com.fasterxml.jackson.databind.ObjectMapper
import com.fasterxml.jackson.module.kotlin.registerKotlinModule
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration

@Configuration
class JacksonConfig {
    @Bean
    fun objectMapper(): ObjectMapper {
        return ObjectMapper().registerKotlinModule()
    }
}

4. 优化枚举的序列化逻辑（可选） #

如果希望序列化时输出枚举的code值（比如"active"而非"ACTIVE"），可以给code属性添加@JsonValue注解：

import com.fasterxml.jackson.annotation.JsonValue

enum class Status private constructor(@JsonValue private val code: String) { 
    ACTIVE("active"), PENDING("pending"); 
    companion object { 
        fun fromString(value: String): Status { 
            return when (value) { 
                "active" -> ACTIVE 
                "pending" -> PENDING 
                else -> throw IllegalArgumentException("Not supported status $value") 
            } 
        } 
    } 
}

这样Jackson序列化时会直接输出code的字符串值，反序列化时也能通过fromString方法正确匹配（Jackson会自动适配）。

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