Spring Boot中如何使用注解校验LocalDateTime日期格式？

方案1：Jackson反序列化配置+全局异常处理（改造成本最低） #

完全保留LocalDateTime字段类型，无需手动做类型转换，仅需两步配置：

• 给VO的日期字段添加Jackson序列化/反序列化格式注解

public class AddMemberVO{
    //会员卡生效时间
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private LocalDateTime startTime;
    
    //会员卡失效时间
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private LocalDateTime endTime;
    
    // 其他字段省略
}

注意：Spring Boot 2.4+ 版本的spring-boot-starter-web已经默认集成JSR310时间类型的序列化支持，无需额外引入依赖

• 添加全局异常处理器，捕获日期格式错误的反序列化异常，返回自定义提示

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(HttpMessageNotReadableException.class)
    public R<String> handleHttpMessageNotReadableException(HttpMessageNotReadableException e) {
        String message = e.getMessage();
        if (message.contains("startTime")) {
            return R.fail("startTime格式无效，要求格式为yyyy-MM-dd HH:mm:ss");
        }
        if (message.contains("endTime")) {
            return R.fail("endTime格式无效，要求格式为yyyy-MM-dd HH:mm:ss");
        }
        return R.fail("请求参数格式错误");
    }
}

方案2：自定义校验注解（适合复杂校验场景） #

如果后续需要增加例如「结束时间必须晚于生效时间」之类的关联校验规则，可以自定义JSR-380校验注解实现更灵活的控制：

• 自定义日期格式校验注解

@Target({ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = DateTimeValidator.class)
public @interface ValidDateTime {
    String message() default "日期格式无效，要求格式为yyyy-MM-dd HH:mm:ss";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    String pattern() default "yyyy-MM-dd HH:mm:ss";
}

• 实现校验器逻辑

public class DateTimeValidator implements ConstraintValidator<ValidDateTime, LocalDateTime> {
    private String pattern;

    @Override
    public void initialize(ValidDateTime constraintAnnotation) {
        this.pattern = constraintAnnotation.pattern();
    }

    @Override
    public boolean isValid(LocalDateTime value, ConstraintValidatorContext context) {
        // 非空校验单独用@NotNull注解实现，这里可补充额外自定义校验逻辑
        return value == null;
    }
}

• 给VO字段添加注解即可

@ValidDateTime
@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
private LocalDateTime startTime;

内容的提问来源于stack exchange，提问作者smallTong