自定义约束注解中@interface.List Groups功能失效问题求助

我之前也踩过这个坑！你遇到的问题本质是：Bean Validation 默认会执行组合注解里的所有内部约束，不会自动根据内部约束的分组进行过滤。哪怕你给内部的@Size指定了分组，校验器还是会一股脑把所有约束都跑一遍，除非你主动配置分组筛选逻辑。下面给你两种可行的解决思路：

方法一：自定义校验器（精准控制分组匹配） #

这是最灵活的方案，能完全按照你预期的逻辑，只执行和当前校验分组匹配的内部约束。

步骤1：修改自定义注解结构 #

把内部的@Size.List改成注解的属性，同时指定自定义校验器：

import jakarta.validation.Constraint;
import jakarta.validation.Payload;
import jakarta.validation.constraints.Size;
import java.lang.annotation.*;

@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
@Constraint(validatedBy = CustomSizeValidator.class) // 指定自定义校验器
public @interface CustomSize {
    String message() default "Size不符合要求";
    Class<?>[] groups() default {}; // 必须保留这个分组属性，用于传递校验时的分组
    Class<? extends Payload>[] payload() default {};

    // 把内部的Size约束集合作为注解属性
    Size.List value();

    @Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
    @Retention(RUNTIME)
    @interface List {
        CustomSize[] value();
    }
}

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

在校验器里手动筛选和当前分组匹配的@Size约束，只执行符合条件的校验：

import jakarta.validation.ConstraintValidator;
import jakarta.validation.ConstraintValidatorContext;
import jakarta.validation.constraints.Size;
import java.util.Arrays;
import java.util.Set;

public class CustomSizeValidator implements ConstraintValidator<CustomSize, CharSequence> {
    private Size[] sizeConstraints;

    @Override
    public void initialize(CustomSize constraintAnnotation) {
        this.sizeConstraints = constraintAnnotation.value().value();
    }

    @Override
    public boolean isValid(CharSequence value, ConstraintValidatorContext context) {
        // 获取当前校验请求的分组集合
        Set<Class<?>> currentGroups = context.getDefaultGroupSequence();

        // 遍历所有内部Size约束，只校验分组匹配的
        for (Size size : sizeConstraints) {
            Class<?>[] constraintGroups = size.groups();
            // 规则：如果约束没指定分组，或者当前分组包含约束的分组，就执行校验
            if (constraintGroups.length == 0 
                || currentGroups.stream().anyMatch(g -> Arrays.asList(constraintGroups).contains(g))) {
                
                // 初始化并执行Size校验
                Size.SizeValidatorForCharSequence validator = new Size.SizeValidatorForCharSequence();
                validator.initialize(size);
                if (!validator.isValid(value, context)) {
                    return false;
                }
            }
        }
        return true;
    }
}

使用示例 #

现在你可以像这样用自定义注解，指定要生效的分组：

public class User {
    @CustomSize(
        value = @Size.List({
            @Size(min = 2, max = 10, groups = Group1.class),
            @Size(min = 5, max = 20, groups = Group2.class)
        }),
        groups = Group1.class // 只触发Group1对应的Size约束
    )
    private String username;
}

方法二：避免内部约束硬编码分组（简化场景） #

如果你的需求不需要给内部约束固定分组，而是让调用者统一指定分组，那可以简化注解定义：

import jakarta.validation.ConstraintComposition;
import jakarta.validation.Payload;
import jakarta.validation.constraints.Size;
import java.lang.annotation.*;

@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
@ConstraintComposition(ConstraintComposition.CompositionType.AND)
@Size(min = 2, max = 10)
@Size(min = 5, max = 20)
public @interface CustomSize {
    String message() default "Size不符合要求";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};

    @Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
    @Retention(RUNTIME)
    @interface List {
        CustomSize[] value();
    }
}

调用时指定分组，两个@Size会同时应用这个分组规则：

@CustomSize(groups = Group1.class)
private String username;

关键注意点 #

1. 自定义注解必须声明groups()属性，这是Bean Validation传递分组信息的入口，不能省略。
2. 对比你那一段能正常运行的代码，大概率是它没有在内部约束中硬编码分组，或者已经实现了类似的自定义校验逻辑。
3. 如果用了Spring Boot等框架，确保校验器被正确扫描到（比如放在@ComponentScan能覆盖的包下）。

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