Spring Boot 3.1.0中Javax Validation注解不生效问题排查

Spring Boot 3.x 基于 Jakarta EE 9 规范，其内置的校验框架已从旧的 javax.validation 迁移到 jakarta.validation 包下。默认使用的 Hibernate Validator 8+ 仅支持 jakarta.validation.constraints 下的注解，你代码中使用的 javax.validation.constraints 系列注解不会被自动识别，导致校验逻辑不生效。

1. 调整依赖版本（兼容javax注解） #

由于你无法移除javax依赖，需要将校验框架降级为支持 javax.validation 的版本，修改pom.xml：

<!-- 保留spring-boot-starter-validation，排除默认的jakarta validation依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
    <exclusions>
        <exclusion>
            <groupId>jakarta.validation</groupId>
            <artifactId>jakarta.validation-api</artifactId>
        </exclusion>
        <exclusion>
            <groupId>org.hibernate.validator</groupId>
            <artifactId>hibernate-validator</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 引入javax.validation API -->
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>2.0.1.Final</version>
</dependency>

<!-- 引入支持javax的Hibernate Validator 7.x版本 -->
<dependency>
    <groupId>org.hibernate.validator</groupId>
    <artifactId>hibernate-validator</artifactId>
    <version>7.0.4.Final</version>
</dependency>

2. 配置校验器Bean #

创建自定义配置类，指定使用javax的校验工厂：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.validation.beanvalidation.LocalValidatorFactoryBean;
import javax.validation.Validation;

@Configuration
public class ValidationConfig {

    @Bean
    public LocalValidatorFactoryBean validator() {
        LocalValidatorFactoryBean factoryBean = new LocalValidatorFactoryBean();
        factoryBean.setValidationProviderResolver(
            () -> Validation.byDefaultProvider().configure().getValidatorFactory()
        );
        return factoryBean;
    }
}

3. 确认Controller注解正确 #

确保Controller类上添加@Validated（Spring提供的注解，用于开启方法级校验），请求参数前添加@Valid（javax.validation下的注解）：

import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;
import javax.validation.Valid;

@RestController
@Validated
public class DemoController {

    @PostMapping("/submit")
    public String submitData(@Valid @RequestBody RequestDto dto) {
        // 业务逻辑
        return "success";
    }
}

4. 检查全局异常处理器（可选） #

如果需要将校验错误返回给前端，添加全局异常处理器捕获校验异常：

import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.validation.BindException;
import org.springframework.web.bind.MethodArgumentNotValidException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import javax.validation.ConstraintViolationException;
import java.util.HashMap;
import java.util.Map;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<Map<String, String>> handleValidationExceptions(MethodArgumentNotValidException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getBindingResult().getFieldErrors().forEach(error -> 
            errors.put(error.getField(), error.getDefaultMessage())
        );
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }

    @ExceptionHandler(ConstraintViolationException.class)
    public ResponseEntity<Map<String, String>> handleConstraintViolationExceptions(ConstraintViolationException ex) {
        Map<String, String> errors = new HashMap<>();
        ex.getConstraintViolations().forEach(violation -> 
            errors.put(violation.getPropertyPath().toString(), violation.getMessage())
        );
        return new ResponseEntity<>(errors, HttpStatus.BAD_REQUEST);
    }
}

如果后续可以逐步迁移，建议将代码中的javax.validation.constraints下的注解替换为jakarta.validation.constraints下的同名注解，移除javax.validation依赖，直接使用Spring Boot 3默认的校验框架，这样无需额外配置即可生效。

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