Spring Boot 动态注册 Bean 的核心是运行时通过 BeanDefinitionRegistry 注册 BeanDefinition，常用方式包括：① BeanDefinitionRegistryPostProcessor 启动期注册；② ApplicationContextInitializer 启动后注册；③ ApplicationRunner 或事件监听实现运行时按需注册，需注意时机、依赖可用性与避坑要点。
Spring Boot 中动态注册 Bean，核心是绕过启动期的静态扫描，改在运行时通过编程方式把 BeanDefinition 注入到 BeanDefinitionRegistry 中。这不是“加个注解”就能搞定的事，而是要操作容器底层机制，关键在于时机、上下文可用性与注册逻辑的可测性。
用 BeanDefinitionRegistryPostProcessor 做启动期动态注册
这是最常用也最稳妥的方式，适合在 Spring 容器刷新前（即所有 BeanDefinition 加载完成但尚未实例化时）注入新 Bean。
- 实现
BeanDefinitionRegistryPostProcessor接口，重写postProcessBeanDefinitionRegistry方法 - 该方法参数就是
BeanDefinitionRegistry，可直接调用registerBeanDefinition - 注意：不能在该方法中调用
getBean()，因为此时单例对象还没创建；如需依赖已有 Bean 的元信息，可用beanFactory.getBeanDefinition("xxx") - 推荐配合
@ConditionalOnMissingBean或自定义条件判断，避免重复注册
用 ApplicationContext 初始化器做启动后注册
如果需要在容器已基本就绪、甚至部分 Bean 已初始化后再注册（比如读取数据库配置后生成服务），可用 ApplicationContextInitializer 或 SpringApplicationRunListener。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 在
SpringApplication构造后、run()执行前添加初始化器：app.addInitializers(ctx -> { ... }) - 此时
ctx是ConfigurableApplicationContext，可安全获取BeanFactory并调用registerSingleton（适用于已知实例的对象）或registerBeanDefinition（适用于需延迟初始化的类） - 注意：注册后若需触发
@PostConstruct、InitializingBean等生命周期回调，得手动调用beanFactory.initializeBean(bean, beanName)
运行时按需注册：结合 ApplicationRunner 或事件监听
真正“动态”的场景，比如插件热加载、规则引擎更新，往往发生在应用启动之后。
- 注入
ConfigurableListableBeanFactory，保存引用供后续使用 - 在业务逻辑中（如收到 HTTP 请求、监听 MQ 消息）构造
BeanDefinitionBuilder，设置 class、构造参数、作用域、是否懒加载等 - 调用
beanFactory.registerBeanDefinition(name, definition) - 若 Bean 有依赖，需确保依赖项已存在；否则注册会成功，但后续
getBean时抛出UnsatisfiedDependencyException - 不建议频繁增删 BeanDefinition，Spring 并未为运行时高频变更做优化，可能引发并发或缓存一致性问题
避坑要点：别让动态注册变成维护黑洞
动态注册不是银弹，容易引入隐式耦合和调试困难。
- 避免在
ImportBeanDefinitionRegistrar中写复杂逻辑——它强依赖容器内部类型，单元测试难，条件判断错一次，线上就静默失效 - 不要手动拼接
ConstructorArgumentValues和MutablePropertyValues，优先用BeanDefinitionBuilder.genericBeanDefinition(clazz).addConstructorArgValue(...) - 注册前务必检查
containsBeanDefinition(name)，同名覆盖会导致意料外行为；若需替换，先removeBeanDefinition再注册 - 注册的 Bean 若含
@Value、@Autowired，确保其所在环境已准备好Environment和AutowiredAnnotationBeanPostProcessor，否则注入失败不报错
