Spring Boot Rest Controller中@DateTimeFormat注解不生效，传入非法日期返回500而非400的问题

你遇到的这个问题我之前也踩过坑，其实是Spring Boot默认的异常处理逻辑在搞鬼——当@DateTimeFormat解析请求参数失败时抛出的TypeMismatchException，并没有被默认映射到HTTP 400（Bad Request）状态码，而是被当成了服务器内部错误返回了500。下面给你几种简单有效的解决办法：

方法一：全局异常处理器（最推荐） #

创建一个全局异常处理类，专门捕获参数类型不匹配的异常，直接返回400状态码和友好提示：

@ControllerAdvice
class GlobalExceptionHandler {

    @ExceptionHandler(TypeMismatchException::class)
    fun handleTypeMismatch(ex: TypeMismatchException): ResponseEntity<String> {
        val errorMsg = "参数格式错误：参数'${ex.propertyName}'的值'${ex.value}'不符合要求，请使用ISO标准日期格式（如yyyy-MM-dd）"
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(errorMsg)
    }
}

只要把这个类放在Spring能扫描到的包下，下次再传入像invalid-date这种非法日期时，接口就会返回400状态码，同时带上清晰的错误提示。

方法二：结合@Validated做自定义验证（可选） #

如果希望更灵活地控制参数验证逻辑，可以配合@Validated和自定义验证注解。不过要注意，这种方式如果还是用LocalDate作为参数类型，Spring依然会先尝试解析，解析失败还是会抛出TypeMismatchException，所以通常需要结合全局异常处理一起用，或者直接接收String参数在验证器里做解析：

1. 先定义一个自定义的日期验证注解：

@Target(AnnotationTarget.VALUE_PARAMETER, AnnotationTarget.FIELD)
@Retention(AnnotationRetention.RUNTIME)
@Constraint(validatedBy = [ValidLocalDateValidator::class])
annotation class ValidLocalDate(
    val message: String = "无效的日期格式，请使用yyyy-MM-dd",
    val groups: Array<KClass<*>> = [],
    val payload: Array<KClass<out Payload>> = []
)

2. 编写对应的验证器：

class ValidLocalDateValidator : ConstraintValidator<ValidLocalDate, String> {
    override fun isValid(dateStr: String?, context: ConstraintValidatorContext?): Boolean {
        if (dateStr.isNullOrBlank()) return false
        return try {
            LocalDate.parse(dateStr, DateTimeFormatter.ISO_DATE)
            true
        } catch (e: DateTimeParseException) {
            false
        }
    }
}

3. 改造控制器方法，接收String参数并加上注解：

@GetMapping("/existClaimAfterDate")
@Validated
fun existClaimAfterDate(
    @RequestParam(value = "afterDate", required = true)
    @ValidLocalDate
    afterDateStr: String,
): Boolean {
    val afterDate = LocalDate.parse(afterDateStr, DateTimeFormatter.ISO_DATE)
    // 你的业务逻辑
}

这种方式可以把解析逻辑放到验证器里，当验证失败时会抛出ConstraintViolationException，同样可以用全局异常处理器捕获并返回400。

补充说明 #

本质上，Spring Boot默认的异常映射规则里，只有少数特定的请求参数异常（比如缺少必填参数）会被自动映射为400，像参数格式解析失败这类异常需要我们手动处理，全局异常处理器是最简洁高效的方案。

备注：内容来源于stack exchange，提问作者squirrelInTheBarel