Spring Boot 默认无法自动将字符串格式的日期参数转换为 java.util.Date 类型，需通过 @DateTimeFormat 显式声明解析规则，或改用 String 接收后手动解析，避免类型转换失败。
spring boot 默认无法自动将字符串格式的日期参数转换为 java.util.date 类型，需通过 @datetimeformat 显式声明解析规则，或改用 string 接收后手动解析，避免类型转换失败。
在 Spring Boot 中，使用 @RequestParam 绑定日期类型参数（如 Date）时，若未正确配置日期格式解析机制，会触发典型的类型转换异常：
Failed to convert value of type 'java.lang.String' to required type 'java.util.Date'
该错误的根本原因在于：Spring 的 WebDataBinder 默认不支持直接将形如 "2024-05-20 14:30:00" 的字符串自动转为 java.util.Date，即使实体类中已用 @JsonFormat 和 @Temporal 注解定义了序列化/持久化行为——这些注解仅作用于 JSON 序列化（@RequestBody）和 JPA 持久化，对 @RequestParam 无效。
✅ 正确解决方案（推荐两种方式）
方案一：使用 String 接收 + 手动解析（简洁可控，适合初学者）
@GetMapping("/flights/search/id")
public ResponseEntity> searchFlightsById(
@RequestParam("departure_from") Airport departureFrom,
@RequestParam("arrival_at") Airport arrivalAt,
@RequestParam("departure_date") String departureDateStr,
@RequestParam(value = "return_date", required = false) String returnDateStr) {
SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
sdf.setLenient(false); // 关键：禁用宽松解析，防止 2024-02-30 被误转为 2024-03-02
try {
Date departureDate = sdf.parse(departureDateStr);
Optional<date> returnDate = Optional.empty();
if (returnDateStr != null && !returnDateStr.trim().isEmpty()) {
returnDate = Optional.of(sdf.parse(returnDateStr));
}
return ResponseEntity.ok(flightService.fetchFlights(departureFrom, arrivalAt, departureDate, returnDate));
} catch (ParseException e) {
return ResponseEntity.badRequest()
.body("Invalid date format. Expected: yyyy-MM-dd HH:mm:ss");
}
}</date>
✅ 优势：逻辑清晰、易于调试、规避 Spring 类型绑定限制；
⚠️ 注意：务必设置setLenient(false)并捕获ParseException，否则非法日期可能静默转换或抛出运行时异常。
方案二：保持 Date 类型 + 全局配置 @DateTimeFormat（更符合 REST 规范）
若坚持使用 Date 参数类型，需确保 @DateTimeFormat 生效且无冲突：
@GetMapping("/flights/search/id")
public ResponseEntity> searchFlightsById(
@RequestParam("departure_from") Airport departureFrom,
@RequestParam("arrival_at") Airport arrivalAt,
@RequestParam("departure_date")
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
Date departureDate,
@RequestParam(value = "return_date", required = false)
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
Date returnDate) { // 注意：Optional<date> 不支持 @DateTimeFormat，应改为可空 Date 或 String
...
}</date>
同时，在配置类中注册 CustomDateFormatter（Spring Boot 2.5+ 可省略，但建议显式声明）：
@Configuration
public class WebConfig implements WebMvcConfigurer {
@Override
public void addFormatters(FormatterRegistry registry) {
DateTimeFormatterRegistrar registrar = new DateTimeFormatterRegistrar();
registrar.setDateFormatter(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
registrar.registerFormatters(registry);
}
}
✅ 优势：参数语义明确，Controller 层更干净；
⚠️ 注意：Optional<date></date>不能直接与@DateTimeFormat同时使用（Spring 不支持），应改用Date+required = false，或退回到String方案。
? 补充建议
-
优先使用
java.time.LocalDateTime替代java.util.Date（自 Java 8 起推荐）：类型安全、线程安全、API 更直观，并天然支持@DateTimeFormat。 - 在
application.properties中统一配置日期格式（可选）：spring.mvc.format.date-time=yyyy-MM-dd HH:mm:ss
- 前端传参时确保 URL 编码正确（空格应编码为
%20，如2024-05-20%2014:30:00）。
通过以上任一方案，即可稳定支持带日期查询的 GET 请求，兼顾健壮性与可维护性。
