如何避免SpringBoot自动配置被组件扫描加载？

针对你提到的场景——自动配置类和普通Bean同属com.mycompany根包、组件扫描范围设为根包的情况，有以下几种可靠的实现方式：

1. 在启动类添加组件扫描排除规则 #

在项目启动类的@SpringBootApplication（或单独的@ComponentScan）注解中，明确排除自动配置类的范围：

• 若自动配置类集中在com.mycompany.autoconfigs子包：

@SpringBootApplication(
    excludeFilters = @ComponentScan.Filter(
        type = FilterType.REGEX,
        pattern = "com.mycompany.autoconfigs.*"
    )
)
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }
}

• 若自动配置类分散在不同子包，可直接指定具体类：

@SpringBootApplication(
    excludeFilters = @ComponentScan.Filter(
        type = FilterType.ASSIGNABLE_TYPE,
        value = {MyAutoConfig1.class, MyAutoConfig2.class}
    )
)

2. 不给自动配置类加组件扫描识别注解 #

Spring Boot自动配置类不需要标注@Component或@Configuration（除非是通过@Import导入的内部配置类）。只要你的自动配置类仅通过META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件声明，不添加任何会被组件扫描捕获的注解，组件扫描就不会加载它们。

注意：如果自动配置类必须用@Configuration，一定要配合上述排除规则，确保它不在扫描范围内。

3. 使用@AutoConfiguration注解（Spring Boot 2.7+） #

Spring Boot 2.7及以上版本引入的@AutoConfiguration注解本身带有防组件扫描的设计：它会被自动配置处理器识别，但默认不会被组件扫描捕获。只要你的自动配置类用@AutoConfiguration替代@Configuration，即使放在组件扫描的包范围内，也不会被意外加载——前提是你没有手动给它添加@Component注解。

4. 拆分自动配置到独立模块（推荐） #

如果项目规模允许，把自动配置类单独抽成一个独立的Jar模块，包名可以沿用同根前缀（比如com.mycompany.autoconfigure），但主项目的组件扫描范围不包含这个模块的包。同时在自动配置模块中通过AutoConfiguration.imports文件声明配置类，主项目依赖该模块即可。这种方式完全符合Spring Boot官方最佳实践，彻底隔离了自动配置和业务Bean的扫描范围。

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