Springboot绑定Date类型时出现日期转换异常问题

一、问题核心描述

在调用接口 /device/list 时，前端传递日期字段 addTime 的格式 2025-07-17 13:30:18，导致 Spring 类型转换失败，无法将字符串自动转为 Date 类型。

问题场景

1. 请求类型：GET 请求（使用 @ModelAttribute 绑定参数）
2. 字段类型：
   • 目标类型：Date
   • 传入值：字符串 "2025-07-17 13:30:18"
3. 错误原因：

Failed to convert property value of type 'java.lang.String' to required type 'java.util.Date' for property 'bindTime'

二、总结：日期格式化场景的解决方案

1. GET请求 + @ModelAttribute方式

解决方案： 使用 Spring的@DateTimeFormat

import org.springframework.format.annotation.DateTimeFormat;

public class DeviceDto {
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date addTime;
}

• 前端传参格式： ?addTime=2025-07-17+14:30:45 (需要正确URL编码)
• 兼容传统 Date 类型

@ModelAttribute 参数绑定 不依赖 Jackson（@JsonFormat 无效）

2. POST请求 + @RequestBody方式 (JSON格式)

解决方案： 使用 Jackson的@JsonFormat

import com.fasterxml.jackson.annotation.JsonFormat;

public class DeviceDto {
    @JsonFormat(
        pattern = "yyyy-MM-dd HH:mm:ss",
        timezone = "GMT+8"
    )
    private Date addTime;
}

• 前端传参格式：

  {"addTime": "2025-07-17 14:30:45"}
  

3. 对于 @DateTimeFormat 是否支持 POST JSON 的问题

** @DateTimeFormat 不能 用于 @RequestBody JSON 反序列化

使用建议总结

“表单数据用@DateTimeFormat，JSON数据用@JsonFormat，Java8时间类型是终极解决方案”