Spring Boot 启动时自动扫描并初始化带自定义注解的 Bean，核心是通过 ImportBeanDefinitionRegistrar 在 Bean 定义阶段注册，或用 SmartInitializingSingleton 在单例初始化后处理，注解本身仅作标记，需配合处理逻辑才能生效。
Spring Boot 启动时自动扫描并初始化带有自定义注解的 Bean，核心在于结合 Spring 的 BeanPostProcessor、ImportBeanDefinitionRegistrar 或 ApplicationContextInitializer 机制，而不是靠注解本身“自动生效”。自定义注解只是标记，真正起作用的是你写的处理逻辑。
1. 定义你的自定义注解
确保注解作用范围支持运行时反射，并能标注在类或方法上（按需选择）：
@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface MyInitBean {
String value() default "";
}
注意：@Retention(RetentionPolicy.RUNTIME) 是必须的，否则启动时无法通过反射读取。
2. 在启动阶段扫描并注册 Bean（推荐用 ImportBeanDefinitionRegistrar）
这是最灵活、最贴近 Spring 容器启动流程的方式。它能在所有 Bean 定义加载完毕但尚未实例化前介入。
立即学习“Java免费学习笔记（深入）”；
- 写一个实现 ImportBeanDefinitionRegistrar 的类
- 配合 @Import 注解，在启动类或配置类上导入
- 利用 BeanDefinitionRegistry 手动注册目标 Bean（或修改已有定义）
示例：
public class MyInitBeanRegistrar implements ImportBeanDefinitionRegistrar {
@Override
public void registerBeanDefinitions(AnnotationMetadata importingClassMetadata,
BeanDefinitionRegistry registry) {
// 获取所有带 @MyInitBean 的候选类（需自己扫描类路径）
ClassPathScanningCandidateComponentProvider scanner =
new ClassPathScanningCandidateComponentProvider(false);
scanner.addIncludeFilter(new AnnotationTypeFilter(MyInitBean.class));
for (BeanDefinition candidate : scanner.findCandidateComponents("com.example")) {
String className = candidate.getBeanClassName();
try {
Class<?> clazz = Class.forName(className);
if (clazz.isAnnotationPresent(MyInitBean.class)) {
// 注册为普通单例 Bean（Spring 自动管理生命周期）
BeanDefinitionBuilder builder = BeanDefinitionBuilder.genericBeanDefinition(clazz);
registry.registerBeanDefinition(Introspector.decapitalize(clazz.getSimpleName()),
builder.getBeanDefinition());
}
} catch (ClassNotFoundException e) {
// 忽略或记录日志
}
}
}
}
然后在启动类上加：
@Import(MyInitBeanRegistrar.class)
@SpringBootApplication
public class Application { ... }
3. 启动后统一初始化（用 SmartInitializingSingleton 或 ApplicationRunner）
如果你不需要提前注册 Bean，而是想在所有单例 Bean 初始化完成后，对已存在的、带注解的 Bean 做额外初始化操作（比如调用某个 init 方法），更简单安全：
- SmartInitializingSingleton：在所有单例 Bean 实例化 & 初始化完成后回调
- ApplicationRunner 或 CommandLineRunner：在 Spring Boot 完全启动后执行
示例（SmartInitializingSingleton）：
@Component
public class MyInitBeanPostProcessor implements SmartInitializingSingleton {
private final List<Object> initBeans = new ArrayList<>();
@Override
public void afterSingletonsInstantiated() {
// 遍历所有已创建的 Bean，筛选带 @MyInitBean 的
ApplicationContext context = ...; // 通常注入 ApplicationContext
String[] beanNames = context.getBeanDefinitionNames();
for (String name : beanNames) {
Object bean = context.getBean(name);
Class<?> beanClass = AopProxyUtils.ultimateTargetClass(bean);
if (beanClass.isAnnotationPresent(MyInitBean.class)) {
// 执行初始化逻辑，比如调用 @PostConstruct 或自定义方法
MyInitBean ann = beanClass.getAnnotation(MyInitBean.class);
System.out.println("Initializing @" + ann.value() + " bean: " + name);
// 可在此处触发 init() 方法、发事件、注册到全局容器等
}
}
}
}
4. 注意事项和常见误区
- 不要试图在自定义注解上加 @Component 或 @Service —— 注解本身不参与组件扫描，除非你手动处理
- 避免在 static 上下文或构造器中依赖未就绪的 Bean（如 ApplicationContext 还没准备好）
- 如果需要 AOP、事务等代理功能，确保被注解的类是 Spring 管理的 Bean（即已被容器注册），否则代理不会生效
- 扫描包路径要准确，否则找不到类；生产环境建议用 basePackages 显式指定
不复杂但容易忽略。关键不是“注解怎么生效”，而是“谁来读它、什么时候读、读完做什么”。选对扩展点，比堆注解更重要。
