SpringBoot 3中DateTimeFormat未严格解析模式，如何恢复旧行为？

• 相关API代码：

@PostMapping(value = "/transactions")
void createTransaction(@RequestParam(required = false) @DateTimeFormat(pattern = "yyyy-MM-dd'T'HH:mm") LocalDateTime startDateTime,
                                        @RequestParam(required = false) @DateTimeFormat(pattern = "yyyy-MM-dd'T'HH:mm") LocalDateTime endDateTime)

• 测试日期：2022-02-02T15:12:23
• 环境变化：从Spring Boot 2.7升级到3.1
• 现象差异：传入上述日期时，Spring Boot 2返回400状态码（符合预期），Spring Boot 3返回200状态码（不符合预期）
• 需求：在Spring Boot 3中维持旧的400响应行为，且不使用fallbackPattern属性的方案

方案1：自定义全局DateTimeFormatter并启用严格解析 #

Spring Boot 3默认放宽了日期解析规则，你可以通过配置类注册一个严格模式的格式化器，覆盖默认逻辑：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.Formatter;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;
import java.util.Locale;

@Configuration
public class DateTimeConfig {

    private static final DateTimeFormatter STRICT_FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd'T'HH:mm")
            .withResolverStyle(ResolverStyle.STRICT);

    @Bean
    public Formatter<LocalDateTime> localDateTimeFormatter() {
        return new Formatter<>() {
            @Override
            public LocalDateTime parse(String text, Locale locale) throws DateTimeParseException {
                return LocalDateTime.parse(text, STRICT_FORMATTER);
            }

            @Override
            public String print(LocalDateTime object, Locale locale) {
                return STRICT_FORMATTER.format(object);
            }
        };
    }
}

该配置会让所有LocalDateTime类型的请求参数使用严格模式解析，当传入包含秒数的日期字符串时，会直接抛出DateTimeParseException，触发400状态码。

方案2：通过配置文件全局设置严格解析风格 #

在application.properties或application.yml中添加以下配置，直接全局调整日期解析的严格性：

spring.mvc.format.date-time=yyyy-MM-dd'T'HH:mm
spring.mvc.format.date-time.resolver-style=strict

此配置会让Spring Boot 3的日期解析行为和Spring Boot 2保持一致，不符合格式的参数会直接返回400。

方案3：自定义校验注解配合@Validated #

如果仅需针对特定接口做严格校验，可以自定义注解实现：

1. 创建校验注解

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import java.lang.annotation.*;

@Documented
@Constraint(validatedBy = StrictDateTimeValidator.class)
@Target({ElementType.PARAMETER, ElementType.FIELD})
@Retention(RetentionPolicy.RUNTIME)
public @interface StrictDateTime {
    String message() default "日期格式错误，必须为yyyy-MM-dd'T'HH:mm";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
    String pattern() default "yyyy-MM-dd'T'HH:mm";
}

2. 实现校验器

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeParseException;
import java.time.format.ResolverStyle;

public class StrictDateTimeValidator implements ConstraintValidator<StrictDateTime, LocalDateTime> {
    private DateTimeFormatter formatter;

    @Override
    public void initialize(StrictDateTime constraintAnnotation) {
        formatter = DateTimeFormatter.ofPattern(constraintAnnotation.pattern())
                .withResolverStyle(ResolverStyle.STRICT);
    }

    @Override
    public boolean isValid(LocalDateTime value, ConstraintValidatorContext context) {
        if (value == null) return true;
        try {
            LocalDateTime.parse(value.format(formatter), formatter);
            return true;
        } catch (DateTimeParseException e) {
            return false;
        }
    }
}

3. 接口中使用注解并开启校验

import jakarta.validation.Valid;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;

@Validated
@PostMapping(value = "/transactions")
void createTransaction(@RequestParam(required = false) @StrictDateTime LocalDateTime startDateTime,
                       @RequestParam(required = false) @StrictDateTime LocalDateTime endDateTime) {
    // 接口逻辑
}

需要在启动类上添加@Validated注解开启方法参数校验。

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