JSR-303验证：如何实现仅非空内部POJO触发@Valid校验？

我之前处理过类似的场景，你遇到的问题本质是@Valid注解的默认行为和预期有偏差：如果嵌套对象是null，@Valid本身不会触发内部属性的校验，但如果你的代码中attributeB是一个空的InnerPojo实例（而非null），或者用了旧版本的Bean Validation规范，就会出现你描述的错误。下面给你几个可行的解决方案：

方案1：确保嵌套对象确实为null（快速排查） #

先检查代码中，当不需要attributeB时，它是否真的被设置为null，而不是被初始化了一个空的InnerPojo实例。比如，你用@NoArgsConstructor生成无参构造时，attributeB默认是null，但如果手动调用了new InnerPojo()，那它就是一个空对象，此时@Valid会校验它的@NotBlank和@NotNull约束，导致错误。

如果只是这个问题，只要确保不需要时attributeB为null即可，无需修改注解。

方案2：自定义「非null时才校验」的注解 #

如果需要更严谨的控制，或者避免误创建空对象的情况，可以自定义一个注解，实现仅当嵌套对象非null时才触发校验：

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

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = ValidWhenPresentValidator.class)
public @interface ValidWhenPresent {
    String message() default "嵌套对象属性不符合约束";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

步骤2：实现校验器 #

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;
import javax.validation.Validator;
import java.util.Set;

public class ValidWhenPresentValidator implements ConstraintValidator<ValidWhenPresent, Object> {

    private final Validator validator;

    // 注入Validator（Spring环境下会自动注入）
    public ValidWhenPresentValidator(Validator validator) {
        this.validator = validator;
    }

    @Override
    public boolean isValid(Object value, ConstraintValidatorContext context) {
        if (value == null) {
            // 对象为null，直接通过校验
            return true;
        }
        // 对象非null，执行嵌套校验
        Set<?> violations = validator.validate(value);
        if (!violations.isEmpty()) {
            // 将嵌套对象的校验错误合并到当前上下文
            context.disableDefaultConstraintViolation();
            violations.forEach(violation -> {
                var violationObj = (javax.validation.ConstraintViolation<?>) violation;
                context.buildConstraintViolationWithTemplate(violationObj.getMessage())
                        .addPropertyNode(violationObj.getPropertyPath().toString())
                        .addConstraintViolation();
            });
            return false;
        }
        return true;
    }
}

步骤3：在POJO中使用 #

@AllArgsConstructor @NoArgsConstructor @Data
class OuterPojo{
    @NotBlank private String attributeA;
    @ValidWhenPresent private InnerPojo attributeB;
}

这样，当attributeB为null时不会触发校验，非null时则会严格校验InnerPojo的所有约束。

方案3：利用分组校验（Spring环境适用） #

如果你的项目用了Spring的@Validated，可以通过分组来区分两种场景：

步骤1：定义校验分组 #

// 分组1：允许attributeB为null
public interface InnerNotRequired {}
// 分组2：要求attributeB非null且有效
public interface InnerRequired {}

步骤2：修改OuterPojo的注解 #

@AllArgsConstructor @NoArgsConstructor @Data
class OuterPojo{
    @NotBlank private String attributeA;
    
    @Valid
    // 分组InnerNotRequired下，允许attributeB为null
    @Null(groups = InnerNotRequired.class)
    // 分组InnerRequired下，要求attributeB非null
    @NotNull(groups = InnerRequired.class)
    private InnerPojo attributeB;
}

步骤3：根据场景选择分组校验 #

在接口或服务中，通过@Validated指定分组：

// 场景1：允许attributeB为null
public void saveOuterPojo(@Validated(InnerNotRequired.class) OuterPojo outerPojo) {
    // 业务逻辑
}

// 场景2：要求attributeB非null且有效
public void saveOuterPojoWithInner(@Validated(InnerRequired.class) OuterPojo outerPojo) {
    // 业务逻辑
}

这个方案适合需要明确区分不同校验场景的业务。

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