如何在运行时查找带@Constraint的未知类型可重复注解？

问题核心 #

你开发的类Bean Validation框架需要扫描所有标记了@Constraint的自定义注解，但当用户把自定义注解设为可重复（添加@Repeatable）后，原注解会被容器注解替代，导致原生Java反射API（getAnnotations()仅返回容器，getAnnotationsByType()需要提前知道注解类型）无法直接获取到目标注解。

优雅解决方案 #

方案1：借助Spring的AnnotatedElementUtils（推荐）

Spring框架提供的AnnotatedElementUtils专门处理注解合并、可重复注解解析等场景，无需关心容器注解类型，直接提取所有带指定元注解的注解实例：

import org.springframework.core.annotation.AnnotatedElementUtils;
import javax.validation.Constraint;
import java.lang.annotation.Annotation;
import java.util.Set;

// 示例：扫描目标类上所有带@Constraint的注解（包括可重复的）
Set<Annotation> constraintAnnos = AnnotatedElementUtils.findAllMergedAnnotations(targetClass, Constraint.class);
for (Annotation anno : constraintAnnos) {
    // 处理每个约束注解的逻辑
    handleConstraintAnnotation(anno);
}

这个方法会自动识别可重复注解的容器，将内部的目标注解全部提取出来，同时还能处理注解继承、元注解传递等复杂场景，比自定义实现更稳定。

方案2：自定义反射解析逻辑（无依赖场景）

如果不想引入Spring依赖，可以自己实现容器注解的解析逻辑，核心是通过@Repeatable元注解识别容器，再反射提取内部注解：

import javax.validation.Constraint;
import java.lang.annotation.Annotation;
import java.lang.annotation.Repeatable;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.List;

public List<Annotation> getAllConstraintAnnotations(java.lang.reflect.AnnotatedElement element) {
    List<Annotation> result = new ArrayList<>();
    for (Annotation anno : element.getAnnotations()) {
        Class<? extends Annotation> annoType = anno.annotationType();
        
        // 直接带@Constraint的注解，加入结果
        if (annoType.isAnnotationPresent(Constraint.class)) {
            result.add(anno);
        }
        
        // 检查是否是可重复注解的容器
        Repeatable repeatableMeta = annoType.getAnnotation(Repeatable.class);
        if (repeatableMeta != null) {
            try {
                // 调用容器注解的value()方法获取内部注解数组
                Method valueMethod = annoType.getDeclaredMethod("value");
                Annotation[] innerAnnotations = (Annotation[]) valueMethod.invoke(anno);
                
                // 遍历内部注解，筛选带@Constraint的
                for (Annotation innerAnno : innerAnnotations) {
                    if (innerAnno.annotationType().isAnnotationPresent(Constraint.class)) {
                        result.add(innerAnno);
                    }
                }
            } catch (NoSuchMethodException | IllegalAccessException | InvocationTargetException e) {
                // 处理不符合规范的容器注解（比如没有value()方法）
                // 可根据框架需求选择抛出异常或忽略
                e.printStackTrace();
            }
        }
    }
    return result;
}

这个逻辑比临时方案更严谨：通过@Repeatable元注解判断容器，而非仅检查value()方法，完全符合Java可重复注解的规范（容器注解必须被@Repeatable标记，且value()返回对应注解数组）。

关于Java原生API设计的说明 #

Java原生getAnnotations()返回的是直接存在于元素上的注解（包括容器注解），getAnnotationsByType()需要指定类型才能解析容器，这是因为Java的可重复注解本质是语法糖，底层依赖容器注解实现。原生API没有提供“扫描所有可重复注解”的通用方法，所以需要借助工具类或自定义解析。

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