Spring Boot 处理日期参数需按传参方式区分：URL 参数用@DateTimeFormat，JSON 用@JsonFormat或Instant；全局配置仅影响@RequestParam/@PathVariable，不影响@RequestBody。
Spring Boot 接收日期时间参数，关键不是“配一个全局开关”，而是按传参方式区分处理：URL 参数（@RequestParam/@PathVariable）、JSON 请求体（@RequestBody）各自有对应机制，混用或漏配都会报 MethodArgumentTypeMismatchException。
URL 路径和查询参数中的日期（如 ?start=2025-10-09 或 /user/2025-10-09）
这类参数由 Spring MVC 的数据绑定机制处理，必须用 @DateTimeFormat 显式声明格式：
-
直接加在方法参数上（推荐，粒度细、易维护）：
@GetMapping("/events")<br>public String list(@DateTimeFormat(pattern = "yyyy-MM-dd") @RequestParam LocalDate date) { ... } -
加在实体类字段上（适合多个参数封装）：
public class Query {<br> @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")<br> private LocalDateTime startTime;<br>}
然后 Controller 方法接收@ModelAttribute Query query -
不写 pattern 很危险：默认只认
2025/10/09这类格式（依赖系统 Locale），前端传2025-10-09就直接 400
JSON 请求体里的日期（如 POST /api/order，body 含 {"createdAt":"2025-10-09 14:30:00"}）
这类由 Jackson 解析，要用 @JsonFormat 注解或全局配置：
-
字段级控制（最常用）：
public class Order {<br> @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")<br> private LocalDateTime createdAt;<br>} -
时间戳支持（毫秒值）：前端传
{"timestamp": 1760010600000}，后端用Instant字段即可自动解析，无需注解
（Instant是时区中立的，比Date更安全） -
避免用
Date类型：它隐含系统默认时区，容易引发时区错乱；优先选LocalDateTime（无时区，需约定前后端都用东八区）或ZonedDateTime（带时区信息）
全局统一格式（适合中后台项目，减少重复注解）
在 application.yml 中配置，仅对 @RequestParam/@PathVariable 生效（不影响 JSON）：
spring:
mvc:
format:
date: yyyy-MM-dd
date-time: yyyy-MM-dd HH:mm:ss
- 这个配置会让所有
LocalDate参数默认按yyyy-MM-dd解析，LocalDateTime默认按yyyy-MM-dd HH:mm:ss - 仍可被
@DateTimeFormat局部覆盖，优先级：局部注解 > 全局配置 -
@RequestBody不走这套逻辑，它只认 Jackson 配置
常见坑与建议
别让时间变成玄学问题：
-
前后端必须对齐时区：如果前端传
"2025-10-09"意思是“北京时间当天零点”，后端就该用LocalDate+@DateTimeFormat，而不是Instant去解析——否则会变成 UTC 时间的 2025-10-08T16:00:00Z -
路径变量里别用复杂格式：
@PathVariable中日期尽量用yyyy-MM-dd，避免空格或冒号（URL 编码麻烦且易出错） - 测试时用 Postman 直接发 raw JSON，别依赖浏览器地址栏拼 URL，后者会自动编码空格和冒号，导致格式错乱
