Spring Boot自动配置Jar中@ComponentScan与@Bean声明Bean的差异疑问

DevOps 小满

2026-8-19

问题

现有一个供Spring Boot应用引入的自动配置Jar（非可执行Jar），包含以下核心内容：

MyComponent.java（包路径：`com.mine.components`）

@Component
public class MyComponent {

    private static final Logger logger = LoggerFactory.getLogger(MyComponent.class);

    @PostConstruct
    public void init() {
        logger.info("MyComponent inited");
    }
}

MyConfiguration.java（包路径：`com.mine.config`）

@Configuration
@ComponentScan(basePackages = "com.mine.components")
public class MyConfiguration {
}

META-INF/spring.factories（位于`src/main/resources`下）

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.mine.config.MyConfiguration

将该Jar引入Spring Boot项目后，MyComponent未被检测到（无初始化日志输出）；但移除@ComponentScan注解，改用@Bean直接声明MyComponent实例后，组件可被正常加载。请问这是什么原因？

原因分析

Spring Boot对自动配置类存在默认过滤机制：自动配置类通过spring.factories加载时，Spring Boot会应用一系列隐式的@Conditional过滤规则，@ComponentScan的扫描行为会被这些规则拦截，导致指定包下的@Component组件无法被扫描到。
自动配置类的设计规范是通过@Bean显式声明组件，而非依赖@ComponentScan。@ComponentScan会扫描整个目标包路径，容易与主应用的组件扫描范围产生冲突，同时也不符合自动配置“按需加载、显式可控”的设计原则。
改用@Bean方式声明MyComponent时，是直接在自动配置类中注册Bean定义，这种方式不受自动配置过滤机制的限制，Spring可以正常识别并初始化该组件。