@Past 和 @Future 是 Spring Boot 中基于 Bean Validation 的时间校验注解，支持 Date、Calendar、LocalDate、LocalDateTime、ZonedDateTime、Instant，不支持 LocalTime、String 或 Long；需配合 @Valid 使用，并常与 @NotNull 组合确保非空校验。
@Past 和 @Future 是 Spring Boot 中基于 Bean Validation（JSR-303/JSR-349）规范的时间校验注解，用于约束日期字段是否属于“过去”或“将来”。它们不依赖业务逻辑，直接在实体类字段上声明即可生效，但需配合 @Valid 或 @Validated 触发校验。
支持的时间类型有哪些
这两个注解支持以下常见时间类型：
java.util.Datejava.util.Calendarjava.time.LocalDatejava.time.LocalDateTimejava.time.ZonedDateTimejava.time.Instant
注意：LocalTime 不支持，因为它不含日期信息，无法判断“过去/将来”；String 或 Long 类型字段也不能直接使用，必须先转换为上述受支持的类型。
@Past 和 @Future 的基本用法
在请求 DTO 或实体类中直接标注字段：
public class EventRequest {
@NotNull(message = "活动开始时间不能为空")
@Past(message = "开始时间不能是未来时间")
private LocalDate startTime;
@NotNull(message = "活动结束时间不能为空")
@Future(message = "结束时间必须是将来时间")
private LocalDateTime endTime;
}
控制器中启用校验：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
@PostMapping("/events")
public ResponseEntity<?> create(@Valid @RequestBody EventRequest request) {
// 校验通过才执行
return ResponseEntity.ok().build();
}
若不加 @Valid，注解不会生效；若字段为 null，@Past/@Future 默认跳过（不报错），所以通常要搭配 @NotNull 使用。
更灵活的边界控制：@PastOrPresent 与 @FutureOrPresent
当允许“今天”或“此刻”也合法时，用这两个替代：
-
@PastOrPresent：接受过去 + 当前日期/时间 -
@FutureOrPresent：接受将来 + 当前日期/时间
例如预约系统允许“立即预约”，则结束时间可设为：
@FutureOrPresent(message = "预约截止时间不能早于现在") private Instant deadline;
注意事项和常见问题
这些细节容易导致校验失效或行为不符合预期：
- 时区敏感：使用
LocalDateTime时，校验基于 JVM 默认时区解析的“当前时间”，建议统一用ZonedDateTime或Instant避免歧义 - 序列化兼容性：前端传
"2025-10-01"给LocalDate字段没问题，但传"2025-10-01T12:00"给LocalDate会反序列化失败，不是校验问题，而是类型不匹配 - 自定义错误消息：建议统一配置 message 属性，避免默认英文提示；也可用属性文件外置管理，如
validation.past=该日期必须在过去 - 嵌套对象校验：若字段在子对象里（如
event.getSchedule().getStart()），需在父类字段上加@Valid，否则子类上的@Past不触发
校验失败时，Spring Boot 默认返回 400 Bad Request，并附带详细错误字段和 message。如需统一格式，可通过全局异常处理器捕获 MethodArgumentNotValidException 处理。
