Spring自动装配多接口实现类时无法获取Java类注解问题求助

问题根因 #

你拿到的batchProcessService实例是Spring生成的动态代理对象（通常是CGLIB代理子类），而非你自己编写的原始实现类实例。代理子类默认不会携带父类上标注的自定义注解、@Service/@Component等原生注解，因此直接调用getClass().isAnnotationPresent()会返回false。你调试时直接用原始类全限定名读取注解正常，就是因为跳过了代理层，直接读取了目标类的元数据。

解决方案 #

直接使用Spring核心包自带的注解工具类处理代理场景即可，不需要自行解析代理对象：

1. 导入Spring注解工具类：import org.springframework.core.annotation.AnnotationUtils;
2. 修改Controller构造方法中的遍历逻辑：

for (var batchProcessService : this.batchProcessImplementations) {
    PickableImplementation anno = AnnotationUtils.findAnnotation(batchProcessService.getClass(), PickableImplementation.class);
    if(anno != null && activeSvcImplementationId.equals(anno.id())) {
        this.batchProcessService = batchProcessService;
        break;
    }
}
// 追加校验逻辑，避免未找到对应实现时空指针
if (this.batchProcessService == null) {
    throw new IllegalArgumentException("未找到匹配id: " + activeSvcImplementationId + "的BatchProcessService实现");
}

如果需要自行获取原始目标类再读取注解，可以使用org.springframework.aop.framework.AopProxyUtils.ultimateTargetClass(batchProcessService)拿到原始类后再做注解判断，效果完全一致。

优化建议 #

1. 实现类上不需要同时标注@Component和@Service，@Service本身已经继承了@Component的语义，保留一个即可。
2. 可以将实现选择逻辑抽到独立配置类中，直接注册为全局可用的BatchProcessService Bean，不需要每个消费方都自行实现选择逻辑：

@Configuration
public class BatchProcessServiceConfig {

    @Bean
    public BatchProcessService batchProcessService(List<BatchProcessService> implementations, Environment env) {
        String activeId = env.getRequiredProperty("buckets-config.active");
        for (var impl : implementations) {
            PickableImplementation anno = AnnotationUtils.findAnnotation(impl.getClass(), PickableImplementation.class);
            if (anno != null && activeId.equals(anno.id())) {
                return impl;
            }
        }
        throw new IllegalArgumentException("未找到匹配id: " + activeId + "的BatchProcessService实现");
    }
}

后续所有需要用到BatchProcessService的地方，直接@Autowired注入即可，不需要注入全部实现列表。

内容的提问来源于stack exchange，提问作者Manuel Díaz