Kotlin+Spring Boot全局Jackson日期格式化配置失效问题

针对Kotlin 1.7.10 + Spring Boot 2.7.1 + Jackson 2.13.3环境下全局日期格式化无效的问题，以下是经过验证的可行方案：

方案一：修正application.properties配置 #

确保使用Spring Boot 2.7.x对应正确配置项，区分不同日期类型的配置规则：

# 适配java.util.Date类型
spring.jackson.date-format=yyyy-MM-dd'T'HH:mm:ss.SSSXXX
spring.jackson.time-zone=UTC

# 适配java.time.*（如LocalDateTime、ZonedDateTime）类型
spring.jackson.serialization.write-dates-as-timestamps=false
spring.jackson.deserialization.adjust-dates-to-context-time-zone=false

注意：如果实体类用的是java.time包下的日期类型，必须开启write-dates-as-timestamps=false，否则Jackson会默认输出时间戳而非ISO格式文本。

方案二：正确实现Jackson2ObjectMapperBuilderCustomizer #

确保配置类被Spring扫描到，同时显式注册必要模块并配置序列化规则：

import com.fasterxml.jackson.databind.SerializationFeature
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule
import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer
import org.springframework.boot.autoconfigure.jackson.Jackson2ObjectMapperBuilderCustomizer
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration
import java.time.format.DateTimeFormatter

@Configuration
class JacksonGlobalConfig {
    @Bean
    fun jacksonCustomizer(): Jackson2ObjectMapperBuilderCustomizer {
        return Jackson2ObjectMapperBuilderCustomizer { builder ->
            // 注册JSR310模块，处理java.time系列日期类型
            val javaTimeModule = JavaTimeModule()
            // 配置LocalDateTime的ISO标准序列化器
            val localDateTimeSerializer = LocalDateTimeSerializer(DateTimeFormatter.ISO_LOCAL_DATE_TIME)
            javaTimeModule.addSerializer(localDateTimeSerializer)
            builder.modules(javaTimeModule)
            
            // 强制关闭时间戳输出，统一用文本格式
            builder.featuresToDisable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
            // 设置全局时区
            builder.timeZone(java.util.TimeZone.getTimeZone("UTC"))
        }
    }
}

注意：如果项目中存在其他标注@Primary的ObjectMapper Bean，会覆盖此配置，需要在该Bean中统一添加日期序列化规则。

方案三：排查潜在冲突点 #

• 检查是否有其他自定义ObjectMapper Bean标注了@Primary，这类Bean会优先于Spring Boot默认配置生效，需在其中同步配置日期规则。
• 确认jackson-module-kotlin依赖已正确引入，若未自动生效，可在配置类中显式注册KotlinModule()。
• 检查实体类日期字段是否被其他注解（如特殊的@JsonProperty配置）干扰，导致全局规则失效。

验证方法 #

编写测试接口验证全局配置效果：

import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.RestController
import java.time.LocalDateTime

@RestController
class DateTestController {
    @GetMapping("/check-date-format")
    fun getTestEntity(): TestEntity {
        return TestEntity(LocalDateTime.now())
    }
}

data class TestEntity(val createTime: LocalDateTime)

调用接口后，查看响应中createTime字段是否为ISO标准格式（如2024-05-20T15:40:00）。

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