Spring Boot未启用Jackson Kotlin插件，JSON转Kotlin数据类失败求助

嘿，我之前也踩过Spring+Jackson Kotlin模块的坑，你的问题我太熟悉了！来一步步帮你解决：

1. 先把依赖配置捋清楚 #

首先得确保Jackson Kotlin模块的版本和你的Jackson核心版本完全一致，Kotlin 1.2.x版本对依赖兼容性要求挺严的。如果是Gradle，依赖应该是这样：

implementation 'com.fasterxml.jackson.module:jackson-module-kotlin:和Jackson核心同版本'

Maven的话：

<dependency>
    <groupId>com.fasterxml.jackson.module</groupId>
    <artifactId>jackson-module-kotlin</artifactId>
    <version>和Jackson核心同版本</version>
</dependency>

划重点：版本必须对齐！不然很容易出现模块加载失败的情况

2. 让Spring全局用你配置的ObjectMapper #

你说在@Bean方法内部配置完ObjectMapper是正常的，但外部不行？这大概率是Spring没把你自定义的ObjectMapper当成全局默认的来用。试试这两种办法：

办法一：用Jackson2ObjectMapperBuilderCustomizer来定制 #

这种方式比直接声明Bean更友好，能和Spring的自动配置融合：

@Configuration
class JacksonConfig {
    @Bean
    fun jacksonCustomizer(): Jackson2ObjectMapperBuilderCustomizer {
        return Jackson2ObjectMapperBuilderCustomizer { builder ->
            // 强制安装Kotlin模块
            builder.modulesToInstall(KotlinModule())
            // 可以加些额外配置，比如忽略未知字段，避免解析报错
            builder.featuresToDisable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES)
        }
    }
}

办法二：直接把自定义ObjectMapper设为全局优先 #

如果上面的办法不管用，直接声明ObjectMapper Bean并标记@Primary，确保Spring优先用你的：

@Configuration
class JacksonConfig {
    @Bean
    @Primary
    fun customObjectMapper(): ObjectMapper {
        return ObjectMapper()
            .registerModule(KotlinModule())
            .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
            // 其他你需要的配置，比如日期格式化之类的
    }
}

为啥内部正常外部不行？因为你在Bean方法里直接用这个ObjectMapper是局部调用，但Spring的RestTemplate、@RequestBody解析这些组件可能还在默认的ObjectMapper，所以必须把自定义的设为全局首选。

3. 搞定非空字段默认值不被覆盖的问题 #

这个坑我也踩过！尤其是数据模型在独立项目里的时候，大概率是Jackson没正确识别Kotlin数据类的构造函数参数。试试这几点：

• 给数据类的构造函数参数加@JsonProperty注解，特别是JSON字段名和Kotlin属性名大小写不一样的时候：

data class User(
    @JsonProperty("user_name")
    val userName: String = "default",
    val age: Int = 0
)

• 检查独立模块的Kotlin编译配置，一定要开启kotlin-spring插件！它会自动处理数据类的构造函数，让Spring和Jackson更好兼容。Gradle里这么加：

plugins {
    id 'org.jetbrains.kotlin.plugin.spring' version '1.2.0'
}

Maven的话配置插件：

<plugin>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-maven-plugin</artifactId>
    <version>1.2.0</version>
    <configuration>
        <compilerPlugins>
            <plugin>spring</plugin>
        </compilerPlugins>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-allopen</artifactId>
            <version>1.2.0</version>
        </dependency>
    </dependencies>
</plugin>

4. 排除Spring自动配置的干扰 #

有时候Spring Boot的默认Jackson自动配置会偷偷覆盖你的自定义配置，你可以试试排除掉它，然后手动配置：

@SpringBootApplication(exclude = [JacksonAutoConfiguration::class])
class YourApplication

然后再用上面的办法配置ObjectMapper。

5. 验证配置是否生效 #

写个简单的测试来确认Kotlin模块真的加载了，以及默认值能被正常覆盖：

@Autowired
lateinit var objectMapper: ObjectMapper

@Test
fun testKotlinModuleWorks() {
    // 检查模块是否加载
    val hasKotlinModule = objectMapper.registeredModules.any { it is KotlinModule }
    assert(hasKotlinModule) { "糟了，Kotlin模块没加载成功！" }
    
    // 测试反序列化覆盖默认值
    val json = """{"user_name":"Alice","age":25}"""
    val user = objectMapper.readValue(json, User::class.java)
    assert(user.userName == "Alice") { "默认值没被覆盖啊！" }
}

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