Spring中JSR 303嵌套字段验证组使用问题及代码示例

问题根源解析 #

你遇到的报错完全是因为两个注解的设计限制：

• @Valid（JSR-303/JSR-380标准）：仅用于触发嵌套验证，没有groups属性，无法直接在字段上指定验证组。
• @Validated（Spring扩展）：支持groups参数，但只能作用在类、方法、方法参数上，不能标记在字段级别。

你的需求是让Person类中的firstAdress和secondAdress分别使用不同的验证组，下面是两种可行的解决办法：

方案一：自定义带分组的字段级验证注解 #

我们可以自定义一个支持指定验证组的注解，用来替代字段上的@Valid，让它触发嵌套验证时只应用指定的组。

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

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import jakarta.validation.Valid;
import java.lang.annotation.*;

@Target({ElementType.FIELD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Valid // 继承@Valid的嵌套验证能力
@Constraint(validatedBy = {}) // 不需要自定义验证器，只借助@Valid的能力
public @interface ValidWithGroups {
    Class<?>[] groups() default {};

    String message() default "Validation failed";

    Class<? extends Payload>[] payload() default {};
}

步骤2：修改Person类的字段注解 #

把原来的@Valid替换成我们自定义的@ValidWithGroups，并指定对应的组：

public class Person {
    private String name;

    @ValidWithGroups(groups = FirstAdress.class)
    private Adress firstAdress;

    @ValidWithGroups(groups = SecondAdress.class)
    private Adress secondAdress;
}

步骤3：在验证时指定组 #

比如在Controller方法里，用@Validated指定要验证的组（如果需要验证所有分组，可以用组合组或者多次验证）：

@RestController
public class PersonController {
    @PostMapping("/person")
    public ResponseEntity<Void> createPerson(@Validated({FirstAdress.class, SecondAdress.class}) @RequestBody Person person) {
        // 业务逻辑
        return ResponseEntity.ok().build();
    }
}

方案二：利用Spring的方法级验证+分组继承 #

如果你的验证场景可以接受通过方法级的分组来区分，也可以用这种更简洁的方式：

步骤1：定义验证组及其继承关系 #

// 基础组
public interface BaseAdressGroup {}

// FirstAdress组继承基础组
public interface FirstAdress extends BaseAdressGroup {}

// SecondAdress组继承基础组
public interface SecondAdress extends BaseAdressGroup {}

步骤2：给Adress的字段指定对应分组 #

public class Adress {
    @Size(min = 5, groups = FirstAdress.class)
    private String street;

    @Size(min = 2, groups = SecondAdress.class)
    private String city;

    // 其他字段...
}

步骤3：在Person类中保留@Valid，然后在验证方法中指定分组 #

比如在Service层或者Controller层，针对不同的场景调用不同分组的验证：

@Service
@Validated
public class PersonService {
    // 验证firstAdress的分组规则
    public void validateFirstAdress(@Validated(FirstAdress.class) Person person) {
        // 方法体内不需要额外逻辑，@Validated会触发验证
    }

    // 验证secondAdress的分组规则
    public void validateSecondAdress(@Validated(SecondAdress.class) Person person) {
        // 同上
    }

    // 同时验证两个分组
    public void validateAllAdress(@Validated({FirstAdress.class, SecondAdress.class}) Person person) {
        // 同上
    }
}

这种方式的核心是：@Valid触发嵌套字段的验证，而@Validated在方法参数上指定的分组会传递给嵌套字段的验证规则，只验证对应分组的注解。

补充说明 #

• 如果你的项目用的是Spring Boot 3.x，记得用jakarta.validation包下的注解，而不是旧的javax.validation。
• 验证组本身只是标记接口，不需要实现任何方法，仅用于区分不同的验证规则集合。

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