运行时@Valid注解方法异常：如何将错误加入约束违规集合

首先得明确核心问题：你在getRequestId()方法里手动抛出ConstraintViolationException的方式，完全违背了Bean Validation（比如Hibernate Validator）的工作机制。这个异常应该是Validator在完成所有验证逻辑、收集完所有违规后，才会选择抛出的（比如调用validateAndThrow()），而你提前在被验证的方法里抛出它，会直接打断Validator的正常流程，导致它没法把错误信息加入到constraintViolations集合中，直接让测试崩溃。

下面给你两种可行的解决方案，根据你的需求选择：

方案一：使用内置注解替代手动判断逻辑 #

这种方式适合逻辑简单的场景，直接用Bean Validation的内置注解来定义约束，去掉手动抛出异常的代码。

步骤1：重构抽象类Request #

移除手动的null判断和异常抛出，让方法直接返回值，同时提供protected的setter让子类能设置requestId：

public abstract class Request implements RequestDto {
    private final IpwRequestMetadataDto req = new IpwRequestMetadataDto();

    @Override
    public String getRequestId() {
        return req.getRequestId();
    }

    // 给子类提供设置requestId的入口
    protected void setRequestId(String requestId) {
        this.req.setRequestId(requestId);
    }

    protected abstract boolean isRequestIdNull();
}

步骤2：在子类中添加对应约束注解 #

根据子类的需求（比如CreateRequest要求requestId不能为null），重写getRequestId()并添加@NotNull注解：

public class CreateRequest extends Request {
    @NotNull(message = "Request id should not be null")
    @Override
    public String getRequestId() {
        return super.getRequestId();
    }

    @Override
    protected boolean isRequestIdNull() {
        return false;
    }

    public void setRequestId(String requestId) {
        super.setRequestId(requestId);
    }
}

这样当你调用validator.validate(dto)时，如果requestId为null，Validator会自动把这个违规加入到constraintViolations集合中，而不是直接抛出异常。

方案二：自定义类级别约束（适合复杂逻辑） #

如果你的业务逻辑需要根据isRequestIdNull()的返回值动态决定约束规则（比如有的子类允许null，有的不允许），可以自定义一个类级别的约束注解和校验器。

步骤1：定义自定义约束注解 #

@Target({TYPE})
@Retention(RUNTIME)
@Constraint(validatedBy = RequestIdValidator.class)
public @interface ValidRequestId {
    String message() default "Request id should {required} be null";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

步骤2：编写自定义校验器 #

这个校验器会根据isRequestIdNull()的返回值来判断requestId是否符合要求，并把错误信息加入到违规集合中：

public class RequestIdValidator implements ConstraintValidator<ValidRequestId, Request> {
    @Override
    public boolean isValid(Request request, ConstraintValidatorContext context) {
        String requestId = request.getRequestId();
        boolean shouldBeNull = request.isRequestIdNull();

        if (shouldBeNull) {
            if (requestId == null) {
                return true;
            }
            // 构建错误信息并添加到违规集合
            context.buildConstraintViolationWithTemplate("Request id should be null")
                   .addPropertyNode("requestId")
                   .addConstraintViolation();
            return false;
        } else {
            if (requestId != null && !requestId.isEmpty()) {
                return true;
            }
            context.buildConstraintViolationWithTemplate("Request id should not be null")
                   .addPropertyNode("requestId")
                   .addConstraintViolation();
            return false;
        }
    }
}

步骤3：给抽象类添加自定义注解 #

@ValidRequestId
public abstract class Request implements RequestDto {
    private final IpwRequestMetadataDto req = new IpwRequestMetadataDto();

    @Override
    public String getRequestId() {
        return req.getRequestId();
    }

    protected void setRequestId(String requestId) {
        this.req.setRequestId(requestId);
    }

    protected abstract boolean isRequestIdNull();
}

这样Validator在验证时会自动调用这个自定义校验器，把所有违规信息都收集到constraintViolations集合里，不会直接抛出异常。

调整测试代码 #

最后你可以修改测试代码来验证效果：

@Test
public void testCreateRequest() {
    var dto = new CreateRequest();
    // 不设置requestId，模拟违规场景
    Set<ConstraintViolation<CreateRequest>> constraintViolations = validator.validate(dto);
    // 断言有一个违规记录
    assertEquals(1, constraintViolations.size());
    // 验证错误信息是否正确
    assertEquals("Request id should not be null", constraintViolations.iterator().next().getMessage());
}

内容的提问来源于stack exchange，提问作者Ali Ben Zarrouk