如何在Spring应用上下文中通过JSR-330 @Qualifier获取指定Bean？

好问题！当你用JSR-330的自定义限定符（比如你写的@Category）标记Bean后，直接从ApplicationContext里获取确实没法像@Inject那样直接用注解，但有几种靠谱的方法可以实现：

方法1：用getBean()结合合成的限定符注解 #

Spring的BeanFactory（ApplicationContext继承了它）支持传入限定符对象来获取匹配的Bean。我们可以用Spring的AnnotationUtils工具类合成一个@Category("simple")的注解实例，然后传给getBean()：

import org.springframework.core.annotation.AnnotationUtils;

// 合成@Category("simple")注解实例
Category categoryQualifier = AnnotationUtils.synthesizeAnnotation(
        Map.of("value", "simple"),
        Category.class,
        null);

// 获取匹配的Bean
SomeThing simpleThing = context.getBean(SomeThing.class, categoryQualifier);

这种方法最直接，和依赖注入时的匹配逻辑一致，推荐优先用这个。

方法2：筛选所有带@Category注解的Bean #

如果你不确定Bean的具体类型，或者想找出所有标注了@Category("simple")的Bean，可以先获取所有带@Category注解的Bean，再过滤出符合value的：

import org.springframework.beans.factory.config.BeanDefinition;

// 获取所有标注了@Category的Bean
Map<String, Object> categoryBeans = context.getBeansWithAnnotation(Category.class);

// 筛选出value为"simple"的Bean
SomeThing targetBean = categoryBeans.values().stream()
        .filter(bean -> {
            // 先尝试从Bean类上拿注解
            Category category = bean.getClass().getAnnotation(Category.class);
            // 注意：如果@Category是标在@Bean方法上（不是Bean类本身），要从BeanDefinition里取
            if (category == null) {
                String beanName = context.getBeanNamesForInstance(bean)[0];
                BeanDefinition beanDef = context.getBeanFactory().getBeanDefinition(beanName);
                if (beanDef.getSource() instanceof Method) {
                    category = ((Method) beanDef.getSource()).getAnnotation(Category.class);
                }
            }
            return category != null && "simple".equals(category.value());
        })
        .map(SomeThing.class::cast)
        .findFirst()
        .orElse(null);

这里要注意一个坑：如果你的@Category是标在配置类的@Bean方法上，而不是SomeThing类本身，那直接从Bean实例的类上拿注解会拿不到，必须从Bean的定义源（也就是那个@Bean方法）里获取。

方法3：用BeanFactoryUtils做更灵活的匹配 #

如果需要更复杂的匹配逻辑（比如要考虑父上下文的Bean），可以用Spring的BeanFactoryUtils工具类配合限定符匹配器：

import org.springframework.beans.factory.BeanFactoryUtils;
import org.springframework.beans.factory.annotation.TypedQualifier;
import org.springframework.core.annotation.AnnotationUtils;

// 创建TypedQualifier，指定类型和自定义限定符
TypedQualifier<SomeThing> qualifier = new TypedQualifier<>(SomeThing.class) {
    @Override
    public Annotation getAnnotation() {
        return AnnotationUtils.synthesizeAnnotation(
                Map.of("value", "simple"),
                Category.class,
                null);
    }
};

// 获取所有符合类型的Bean名称（包括父上下文）
String[] candidateBeanNames = BeanFactoryUtils.beanNamesForTypeIncludingAncestors(
        context,
        SomeThing.class,
        true,
        false);

// 遍历找到匹配限定符的Bean
SomeThing simpleThing = null;
for (String beanName : candidateBeanNames) {
    if (context.getBeanFactory().isTypeMatch(beanName, qualifier)) {
        simpleThing = context.getBean(beanName, SomeThing.class);
        break;
    }
}

这种方法适合需要跨上下文查找，或者有额外匹配条件的场景。

额外注意点 #

• 确保你的@Category注解确实被标记为@Qualifier（你已经做到了），这样Spring才会把它当作限定符处理。
• 如果有多个Bean符合@Category("simple")的条件，上面的示例会返回第一个匹配的；如果需要所有匹配的Bean，把findFirst()改成collect(Collectors.toList())即可。

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