Spring Boot中日期解析失败发生在校验前，属参数绑定阶段类型转换异常；需分别配置Jackson反序列化、自定义Converter及@DateTimeFormat注解，并用@ControllerAdvice统一捕获HttpMessageNotReadableException和MethodArgumentTypeMismatchException。
Spring Boot 中日期时间字符串解析失败发生在进入校验器（如 `@Valid`）之前，本质是参数绑定阶段的类型转换失败，属于 MethodArgumentTypeMismatchException 或 HttpMessageNotReadableException 的范畴。这类异常不会被 Bean Validation 拦截，因为校验器只作用于已成功绑定的对象字段，而解析失败发生在对象创建或字段赋值前。
为什么解析失败早于校验器？
Spring MVC 的请求处理流程是线性的：
- 先由
HandlerMethodArgumentResolver尝试将原始请求数据（URL 参数、JSON 字段等）转换为目标 Java 类型（如LocalDateTime） - 若转换失败（例如字符串 "2024-03-14 18:55:55" 无法匹配默认格式），直接抛出异常，请求终止
- 只有转换成功后，才会把构造好的对象交给
@Valid触发校验逻辑
常见触发场景及对应解法
1. JSON 请求体中的 LocalDateTime/LocalDate 解析失败
前端传 {"startTime":"2026-09-15 10:30:00"}，后端用 @RequestBody OrderDTO dto 接收，但没配置 Jackson 对 Java 8 时间类型的反序列化支持。
- 添加
JavaTimeModule并禁用时间戳输出：
在 Jackson 配置类中注册模块：builder.modules(new JavaTimeModule().disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)); - 配合
LocalDateTimeDeserializer指定输入格式：builder.deserializers(new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")))
2. GET 请求参数（@RequestParam）解析失败
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
比如 @GetMapping("/list") public List<X> query(@RequestParam LocalDateTime start)，但 URL 是 ?start=2026-09-15 10:30:00。
- 不能靠
@JsonFormat（它只对 JSON 生效） - 必须注册自定义
Converter<String, LocalDateTime>，并确保它被纳入WebMvcConfigurer.addFormatters() - 示例：
@Bean public Converter<String, LocalDateTime> localDateTimeConverter() {<br> return source -> LocalDateTime.parse(source, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")); }
3. @PathVariable 或表单字段解析失败
路径变量如 /order/{date} 中的 date 是字符串，需转为 LocalDate。
- 使用
@DateTimeFormat(pattern = "yyyy-MM-dd")直接标注在方法参数上：public String get(@PathVariable @DateTimeFormat(pattern = "yyyy-MM-dd") LocalDate date) - 该注解会触发 Spring 内置的
FormattingConversionService，无需额外配置 Converter
统一兜底：全局异常处理器捕获早期解析异常
即使配置到位，仍可能遇到非法输入（如 "abc"）。建议用 @ControllerAdvice 捕获两类核心异常：
-
HttpMessageNotReadableException：JSON 解析失败（含日期反序列化） -
MethodArgumentTypeMismatchException：URL 参数、路径变量等类型转换失败
在异常处理器中返回结构化错误提示（如错误码、字段名、期望格式），避免暴露堆栈信息。
