Spring MVC：如何避免在控制器与实体类中重复编写验证逻辑

你遇到的这个问题确实很常见——不想在Person实体和PersonForm表单类中重复编写相同的验证约束，同时希望在所有更新Person的路由中复用统一的验证规则。Spring默认并不会自动将实体类的验证约束同步到表单类，但有几种优雅的方式可以解决这个问题：

方案1：使用验证分组（Validation Groups）统一约束定义 #

这种方式适合将通用验证规则抽离为分组，在实体和表单类中共同引用，避免重复注解。

步骤1：定义验证分组接口 #

先创建标记用的分组接口，区分不同场景的验证规则（比如创建、更新）：

public interface PersonValidationGroups {
    // 创建场景的验证分组
    interface Create {}
    // 更新场景的验证分组
    interface Update {}
}

步骤2：在实体类中绑定分组 #

修改Person实体的验证注解，指定对应的分组：

@Entity
public class Person {
    @NotBlank(groups = {PersonValidationGroups.Create.class, PersonValidationGroups.Update.class})
    private String name;

    @Email(groups = {PersonValidationGroups.Create.class, PersonValidationGroups.Update.class})
    private String email;

    // 其他字段、getter/setter...
}

步骤3：在表单类中复用分组约束 #

在PersonForm的字段上直接引用实体类的分组约束，不需要重复写具体的验证注解：

public class PersonForm {
    @NotBlank(groups = {PersonValidationGroups.Create.class, PersonValidationGroups.Update.class})
    private String name;

    @Email(groups = {PersonValidationGroups.Create.class, PersonValidationGroups.Update.class})
    private String email;

    // 表单专属字段、getter/setter...
}

步骤4：在控制器中指定验证分组 #

使用@Validated注解替代@Valid，指定要生效的分组：

@PostMapping("/person/save")
public String savePerson(@Validated(PersonValidationGroups.Create.class) PersonForm personForm, BindingResult bindingResult) {
    if (bindingResult.hasErrors()) {
        // 处理验证错误
        return "person-form";
    }
    // 映射到Person实体并保存
    return "redirect:/persons";
}

这种方式的优势是规则统一维护在分组接口中，实体和表单类仅需引用分组，适合约束规则需要在多个类中复用的场景。

方案2：自定义验证器，直接复用实体类的约束 #

如果不想在表单类中重复写任何验证注解，可以自定义一个验证器，直接读取Person实体的约束元数据，对PersonForm的对应字段进行验证。

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

创建一个类级别的验证注解，用于标记PersonForm需要复用实体的验证规则：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = PersonFormValidator.class)
public @interface PersonFormValid {
    String message() default "表单字段不符合实体验证规则";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

步骤2：实现自定义验证器 #

编写验证器逻辑，读取Person类的约束信息，对PersonForm的对应字段进行验证：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.util.StringUtils;
import javax.validation.*;
import java.lang.reflect.Method;
import java.util.Set;

public class PersonFormValidator implements ConstraintValidator<PersonFormValid, PersonForm> {
    private final Validator validator;
    private BeanDescriptor personBeanConstraints;

    @Autowired
    public PersonFormValidator(Validator validator) {
        this.validator = validator;
        // 提前加载Person实体的约束元数据
        this.personBeanConstraints = validator.getConstraintsForClass(Person.class);
    }

    @Override
    public boolean isValid(PersonForm form, ConstraintValidatorContext context) {
        boolean isValid = true;

        // 遍历Person实体的所有约束字段
        for (PropertyDescriptor propertyDesc : personBeanConstraints.getConstrainedProperties()) {
            String propertyName = propertyDesc.getPropertyName();
            Object formFieldValue = getFormFieldValue(form, propertyName);

            if (formFieldValue == null) continue;

            // 使用实体类的约束验证表单字段值
            Set<ConstraintViolation<Object>> violations = validator.validateValue(Person.class, propertyName, formFieldValue);
            for (ConstraintViolation<Object> violation : violations) {
                // 将验证错误绑定到表单的对应字段
                context.disableDefaultConstraintViolation();
                context.buildConstraintViolationWithTemplate(violation.getMessage())
                        .addPropertyNode(propertyName)
                        .addConstraintViolation();
                isValid = false;
            }
        }
        return isValid;
    }

    // 通过反射获取表单类对应字段的值
    private Object getFormFieldValue(PersonForm form, String propertyName) {
        try {
            Method getter = PersonForm.class.getMethod("get" + StringUtils.capitalize(propertyName));
            return getter.invoke(form);
        } catch (Exception e) {
            // 表单类中不存在该字段，跳过验证
            return null;
        }
    }
}

步骤3：在表单类上标记自定义注解 #

给PersonForm加上@PersonFormValid注解：

@PersonFormValid
public class PersonForm {
    private String name;
    private String email;
    // 表单专属字段、getter/setter...
}

步骤4：在控制器中使用常规验证 #

现在只需要用@Valid注解就能触发自定义验证器，自动复用Person实体的约束：

@PostMapping("/person/save")
public String savePerson(@Valid PersonForm personForm, BindingResult bindingResult) {
    // 验证逻辑和之前一致
    ...
}

这种方式的优势是完全不需要在表单类中写任何验证注解，所有规则都维护在实体类中，适合实体约束频繁变动的场景。

方案3：嵌套实体验证（适合表单类可嵌套的场景） #

如果可以接受PersonForm中嵌套一个Person实例，可以直接用@Valid注解触发实体的验证，同时保留表单专属字段：

public class PersonForm {
    // 嵌套实体并启用验证
    @Valid
    private Person person;
    // 表单专属字段，比如验证码
    private String captcha;
    // getter/setter...
}

控制器中验证PersonForm时，会自动验证嵌套的Person实例，不需要重复写约束。这种方式最简单，但需要调整表单类的结构。

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