Spring场景下如何反序列化含LocalDate字段的Kotlin类

问题根源分析 #

你的问题主要出在两个核心点上：

1. @PathVariable的使用逻辑错误：你试图把路径中单个日期字符串直接绑定到DateInput自定义类上，但Spring无法自动将单一字符串转换为自定义对象，这才触发了MethodArgumentConversionNotSupportedException异常。
2. ObjectMapper配置的适用范围有限：你配置的JavaTimeModule和KotlinModule仅负责处理@RequestBody（请求体）的JSON序列化/反序列化，而路径变量（@PathVariable）的参数转换依赖Spring的Converter机制，和ObjectMapper无关。

针对性解决方案 #

方案1：直接接收LocalDate作为@PathVariable参数 #

这是最简洁的处理方式，不需要自定义类，直接在接口参数上通过@DateTimeFormat指定日期格式即可：

@GetMapping(path = ["/input/{date}"])
fun fetchInsurance(@PathVariable("date") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) date: LocalDate) {
    // 业务逻辑处理
}

如果你的日期格式不是ISO标准格式（比如01-01-2000），可以修改注解指定自定义pattern：

@DateTimeFormat(pattern = "dd-MM-yyyy")

方案2：用@RequestBody传递DateInput类（POST请求场景） #

如果必须将日期封装到自定义类中，建议改用POST请求，通过请求体传递JSON数据，此时你配置的ObjectMapper会自动生效：

接口代码修改：

@PostMapping(path = ["/input"])
fun fetchInsurance(@RequestBody dateInput: DateInput) {
    // 业务逻辑处理
}

DateInput类（可省略@DateTimeFormat，因为ObjectMapper已配置JavaTimeModule）：

class DateInput(var date: LocalDate) { }

请求时传递的JSON格式为：{"date": "2000-01-01"}，Spring会自动完成反序列化。

方案3：自定义Converter支持@PathVariable绑定DateInput #

如果坚持要在@PathVariable场景下使用DateInput类，可以自定义一个Converter让Spring知道如何将字符串转换为你的类：

1. 创建自定义Converter组件：

@Component
class StringToDateInputConverter : Converter<String, DateInput> {
    override fun convert(source: String): DateInput {
        val localDate = LocalDate.parse(source, DateTimeFormatter.ISO_DATE)
        return DateInput(localDate)
    }
}

2. 保持原接口代码不变：

@GetMapping(path = ["/input/{date}"])
fun fetchInsurance(@PathVariable("date") date: DateInput) {
    // 业务逻辑处理
}

Spring会自动识别并使用这个Converter完成参数转换。

额外优化建议 #

如果使用Spring Boot，其实可以简化ObjectMapper的配置：

• 确保项目中引入了jackson-datatype-jsr310（Spring Boot默认已包含）和kotlin-reflect依赖
• 在application.properties中添加配置：

spring.jackson.serialization.write-dates-as-timestamps=false

Spring会自动配置支持Java 8时间类型的ObjectMapper，无需手动创建Bean。

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