Spring Boot 非Controller类使用javax.validation校验并抛出MethodArgumentNotValidException的实现

1. 注入Spring托管的校验器 #

在需要执行校验的非Controller类（需交给Spring容器托管）中，直接注入Spring自动装配完成的校验器，无需手动初始化Validator实例：

@Component
public class ManualValidationService {
    // 注入的校验器与Controller层使用的校验器同源，完整兼容所有javax.validation规范注解
    @Autowired
    private Validator validator;
}

该校验器可正常触发@NotNull、@NotEmpty、@NotBlank、@Pattern等所有标准校验注解的校验逻辑。

2. 实现校验逻辑并构造符合要求的异常对象 #

MethodArgumentNotValidException的构造依赖两个核心参数：代表方法上下文的MethodParameter、存储校验结果的BindingResult。手动实现时可直接基于校验结果构造这两个参数，无需依赖Spring MVC的调用链路：

void validationClass(boolean value) throws NoSuchMethodException {
    ClassTest classTest = new ClassTest();
    // 原有对象赋值逻辑保持不变

    if (value) {
        // 执行类级手动校验，获取所有校验违规项
        Set<ConstraintViolation<ClassTest>> violations = validator.validate(classTest);

        // 构造Spring标准的绑定结果对象
        BeanPropertyBindingResult bindingResult = new BeanPropertyBindingResult(
            classTest,
            ClassTest.class.getName()
        );
        // 将每条校验错误映射到绑定结果中
        for (ConstraintViolation<ClassTest> violation : violations) {
            bindingResult.addError(new FieldError(
                violation.getRootBeanClass().getName(),
                violation.getPropertyPath().toString(),
                violation.getInvalidValue(),
                false,
                null,
                null,
                violation.getMessage()
            ));
        }

        // 构造方法参数上下文对象，直接使用当前执行校验的方法即可
        Method targetMethod = ManualValidationService.class.getDeclaredMethod("validationClass", boolean.class);
        MethodParameter methodParameter = new MethodParameter(targetMethod, 0);

        // 抛出标准MethodArgumentNotValidException
        throw new MethodArgumentNotValidException(methodParameter, bindingResult);
    } else {
        // 原有业务逻辑保持不变
    }
}

注意事项 #

• 该方式抛出的异常结构与Controller层参数校验抛出的MethodArgumentNotValidException完全一致，全局异常处理器无需写额外适配逻辑，可直接复用原有异常处理分支
• 所有校验失败的提示信息、字段映射关系会完整透传，和Controller层的校验输出无差异
• 禁止手动通过Validation.buildDefaultValidatorFactory()初始化校验实例，否则会出现与Spring环境配置不一致的问题，包括消息源绑定、自定义注解失效等情况

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