Spring框架文档Bean注册矛盾及非运行时注入实现问询

两个文档描述的差异核心是对「运行时」阶段的界定：

官方不支持的操作：指 ApplicationContext 完全刷新（refresh() 执行完成）、容器已进入对外提供服务的运行状态后，并发进行Bean注册和Bean访问的场景。
官方允许的操作：指在容器启动流程的特定节点，无并发访问风险的前提下进行Bean注册。

符合规范的注册实现方式 #

1. 基于 BeanFactoryPostProcessor 扩展点注册（最常用） #

这是Spring官方原生支持的标准扩展方式，执行时机为：所有BeanDefinition已被扫描加载完成，但还未实例化任何Bean，整个阶段处于容器启动流程内，无并发访问风险，完全合规。
示例代码：

@Component
public class CustomBeanRegisterPostProcessor implements BeanFactoryPostProcessor {
    @Override
    public void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException {
        // 注册容器外部创建的已有单例对象
        MyExternalService externalService = new MyExternalService();
        beanFactory.registerSingleton("externalService", externalService);

        // 注册自定义BeanDefinition
        BeanDefinition customBeanDef = BeanDefinitionBuilder
                .genericBeanDefinition(CustomBizBean.class)
                .addPropertyReference("externalService", "externalService")
                .setScope(BeanDefinition.SCOPE_SINGLETON)
                .getBeanDefinition();
        ((DefaultListableBeanFactory) beanFactory)
                .registerBeanDefinition("customBizBean", customBeanDef);
    }
}

这个方式的优点是不需要手动控制容器启动流程，Spring会自动执行该扩展点的注册逻辑，所有注册的Bean会完整走Spring的生命周期回调、依赖注入流程，不存在状态不一致问题。

2. 手动初始化容器时，刷新前注册 #

如果是手动创建ApplicationContext实例，可以在调用refresh()方法之前完成Bean注册，此时容器还未进入运行状态，无并发风险，示例代码：

public class ManualContainerStarter {
    public static void main(String[] args) {
        AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext();
        DefaultListableBeanFactory beanFactory = context.getDefaultListableBeanFactory();
        
        // 刷新前注册自定义Bean
        beanFactory.registerSingleton("globalConfig", new GlobalExternalConfig());
        
        // 注册配置类、扫描包，最后执行刷新
        context.register(AppConfig.class);
        context.scan("com.example.biz");
        context.refresh();
    }
}

禁止场景说明 #

容器refresh()执行完成后，除非你能100%保证注册操作期间没有任何线程访问BeanFactory、也没有Bean正在被创建，否则不要调用registerSingleton/registerBeanDefinition方法，这种场景下的并发操作会触发ConcurrentModificationException、新Bean的依赖未注入、后置处理器未执行等问题，官方不提供兼容性保障。

内容的提问来源于stack exchange，提问作者z Yiazzz