调用AnnotationConfigWebApplicationContext.refresh()触发NoSuchBeanDefinitionException问题问询

这事儿我熟，之前踩过类似的坑！核心矛盾点在于：refresh()方法会重置上下文的Bean查找逻辑，导致原本能跨上下文访问rootContext Bean的子上下文，在refresh后丢失了对父上下文的依赖访问权限。

为什么不调用refresh()时一切正常？ #

在Spring Web环境中，比如DispatcherServlet对应的子上下文，默认会自动继承ContextLoaderListener初始化的rootContext的Bean定义。这时候子上下文在进行自动装配时，会优先在自身查找Bean，找不到的话就去父上下文（rootContext）里找——所以你的Bean x虽然在rootContext，但子上下文依然能正常注入，程序启动无报错。

调用refresh()后为啥就找不到Bean x了？ #

AnnotationConfigWebApplicationContext#refresh()是上下文的全量初始化方法，它会触发以下操作：

• 清空现有的BeanFactory
• 重新加载所有注册的配置类和Bean定义
• 重新初始化所有单例Bean

如果你的代码里在调用register()后直接调用refresh()，但没有提前设置父上下文，那么这个上下文就会变成一个独立的“根上下文”，不再继承原来的rootContext。这时候它只能看到自己注册的Bean，自然找不到rootContext里的Bean x，抛出NoSuchBeanDefinitionException。

解决方案 #

1. 手动设置父上下文后再调用refresh()

在调用refresh()之前，把rootContext设置为当前上下文的父上下文，这样refresh后的上下文依然能从父上下文查找Bean：

// 获取已初始化的rootContext（比如从ContextLoader.getCurrentWebApplicationContext()）
WebApplicationContext rootContext = ContextLoader.getCurrentWebApplicationContext();

AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
ctx.setParent(rootContext); // 关键：关联父上下文
ctx.register(YourCustomConfig.class); // 注册你的新配置类
ctx.refresh();

2. 避免不必要的refresh()调用

如果你的需求只是注册新的配置类或Bean，而非重置整个上下文，完全可以不用调用refresh()。Spring在Web环境下已经有成熟的上下文初始化流程，手动调用refresh()反而容易破坏原有上下文的继承关系。

3. 动态注册Bean的替代方案

如果需要动态添加Bean定义，可以直接操作BeanDefinitionRegistry，不用触发全量refresh：

AnnotationConfigWebApplicationContext ctx = ...;
BeanDefinitionRegistry registry = (BeanDefinitionRegistry) ctx.getBeanFactory();
// 注册新的Bean定义
registry.registerBeanDefinition("yourBeanName", yourBeanDefinition);

注意事项 #

• 不要在Web环境中随意调用上下文的refresh()方法，这会打乱Spring原本的上下文生命周期管理。
• 确保rootContext已经完成初始化后，再创建并关联子上下文，否则父上下文可能还没加载Bean x，依然会出现找不到的情况。

内容的提问来源于stack exchange，提问作者Johan Sjöberg