无需启动Spring容器，如何测试SpringBoot的@Valid校验？

你希望在不启动Spring容器或服务器的前提下，验证Spring Boot请求中@Valid注解的校验功能，就像之前手动校验时直接测试方法那样，而非使用@WebMvcTest这类需要启动容器的集成测试方式。

解决方案：直接使用Jakarta Validation标准API #

Spring的@Valid注解本质是集成了JSR-380（Jakarta Validation）规范，底层依赖Hibernate Validator这类实现。我们可以直接使用Jakarta Validation的原生API来校验请求对象，完全脱离Spring容器。

步骤1：确认依赖已存在

如果你的项目引入了spring-boot-starter-validation依赖，那么已经包含了Hibernate Validator和Jakarta Validation API，无需额外添加。

步骤2：编写单元测试

无需任何Spring相关注解，直接实例化Validator并校验请求对象：

import jakarta.validation.Validation;
import jakarta.validation.Validator;
import jakarta.validation.ValidatorFactory;
import jakarta.validation.ConstraintViolation;
import org.junit.jupiter.api.Test;

import java.util.Set;

import static org.junit.jupiter.api.Assertions.*;

class SomeRequestValidationTest {

    private final Validator validator;

    // 初始化Validator实例
    public SomeRequestValidationTest() {
        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
        validator = factory.getValidator();
    }

    @Test
    void 当clientId为null时校验失败() {
        SomeRequest request = new SomeRequest(null);
        Set<ConstraintViolation<SomeRequest>> violations = validator.validate(request);
        
        assertFalse(violations.isEmpty());
        assertEquals("must not be null", violations.iterator().next().getMessage());
    }

    @Test
    void 当clientId为空字符串时校验失败() {
        SomeRequest request = new SomeRequest("");
        Set<ConstraintViolation<SomeRequest>> violations = validator.validate(request);
        
        assertFalse(violations.isEmpty());
        assertEquals("must not be empty", violations.iterator().next().getMessage());
    }

    @Test
    void 当clientId有效时校验通过() {
        SomeRequest request = new SomeRequest("valid-client-id");
        Set<ConstraintViolation<SomeRequest>> violations = validator.validate(request);
        
        assertTrue(violations.isEmpty());
    }
}

步骤3：如果要测试Controller方法

直接调用Controller的方法时，Spring MVC的参数校验拦截器不会自动触发，因此需要手动校验请求对象，模拟Spring的校验逻辑：

import jakarta.validation.ConstraintViolation;
import jakarta.validation.Validation;
import jakarta.validation.Validator;
import jakarta.validation.ValidatorFactory;
import org.junit.jupiter.api.Test;

import java.util.Set;

import static org.junit.jupiter.api.Assertions.assertFalse;

class FieldValidationControllerTest {

    private final Validator validator;
    private final FieldValidationController controller;

    public FieldValidationControllerTest() {
        ValidatorFactory factory = Validation.buildDefaultValidatorFactory();
        validator = factory.getValidator();
        controller = new FieldValidationController();
    }

    @Test
    void 当请求参数无效时校验失败() {
        SomeRequest invalidRequest = new SomeRequest("");
        Set<ConstraintViolation<SomeRequest>> violations = validator.validate(invalidRequest);
        
        // 验证校验结果
        assertFalse(violations.isEmpty());
        
        // 若需模拟Spring抛出的异常，可手动抛出ConstraintViolationException
        if (!violations.isEmpty()) {
            throw new jakarta.validation.ConstraintViolationException(violations);
        }
    }
}

说明 #

这种方式完全不依赖Spring容器，直接使用Jakarta Validation的标准API进行校验，和Spring在Controller层通过@Valid实现的校验逻辑完全一致——因为Spring底层就是用这个Validator来处理参数校验的。

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