未传入配置类时Spring的@ComponentScan为何失效？上下文需刷新原因

1. @ComponentScan不生效的原因 #

你把@ComponentScan标注在了Application类上，但这个类并没有被Spring识别为配置类。当你使用无参构造new AnnotationConfigApplicationContext()创建上下文时，Spring默认不会自动扫描当前类或其他未指定的类——它不知道要把哪个类当作配置源来处理，所以你的@ComponentScan注解完全没被Spring读取到，自然不会执行组件扫描。

2. 为什么传入配置类到构造器就能正常运行 #

AnnotationConfigApplicationContext(Class<?>... annotatedClasses)这个带参数的构造器做了两件关键的事：

• 自动把你传入的类注册为Spring的配置类（不管这个类有没有@Configuration注解，只要带@ComponentScan、@Bean等Spring注解都会被处理）
• 自动调用refresh()方法完成上下文的初始化流程

这两步是无参构造不会自动执行的，所以直接传配置类就能让Spring扫描到你的Bean。

3. 上下文为什么需要刷新 #

Spring上下文的初始化是一个多阶段的过程，refresh()是触发整个初始化流程的核心方法，它会执行：

• 加载配置类、解析注解（比如@ComponentScan、@Bean）
• 扫描指定包下的所有组件（@Component、@Service等标注的类）
• 创建并初始化所有Bean实例
• 处理依赖注入、Bean的生命周期回调等

如果不调用refresh()，上下文只是一个空的容器，没有完成任何初始化操作，此时调用getBean()必然会抛出has not been refreshed yet的异常——因为容器里根本没有任何Bean。

修正后的代码示例 #

方式一：手动注册配置源并刷新上下文 #

如果想保留当前的Application类结构，可以手动向上下文注册配置类，然后调用refresh()：

public class Application {
    public static void main(String[] args) {
        try(var context = new AnnotationConfigApplicationContext()){
            // 注册配置类
            context.register(ProjectConfig.class);
            // 手动触发上下文初始化
            context.refresh();
            
            MyBean mybean = context.getBean(MyBean.class);
            System.out.println(mybean.getMessage());
        }
    }
}

方式二：把Application改成配置类并传入构造器 #

直接给Application加上@Configuration注解，让它成为配置类，然后传入构造器：

@Configuration
@ComponentScan("com.main.config")
public class Application {
    public static void main(String[] args) {
        try(var context = new AnnotationConfigApplicationContext(Application.class)){
            MyBean mybean = context.getBean(MyBean.class);
            System.out.println(mybean.getMessage());
        }
    }
}

方式三：使用上下文的scan方法指定扫描包 #

也可以直接用上下文的scan()方法指定要扫描的包，然后刷新：

public class Application {
    public static void main(String[] args) {
        try(var context = new AnnotationConfigApplicationContext()){
            // 直接指定扫描的包
            context.scan("com.main.config");
            context.refresh();
            
            MyBean mybean = context.getBean(MyBean.class);
            System.out.println(mybean.getMessage());
        }
    }
}

内容的提问来源于stack exchange，提问作者Sasirekha Kumaran