@ComponentScan 是 Spring 框架中用于自动扫描并注册组件的核心注解，它简化了 Spring 应用中 Bean 的发现和装配流程。以下从核心功能、属性解析、使用场景及示例等方面进行详细说明。

---

一、核心功能与作用

1. 自动扫描组件
   @ComponentScan 会扫描指定包及其子包下的类，识别并注册标注了 @Component、@Service、@Repository、@Controller 等注解的类为 Spring Bean。

2. 替代 XML 配置
   与 XML 配置 <context:component-scan> 功能等价，但通过注解实现更简洁的配置。

3. 支持自定义过滤规则
   通过 includeFilters 和 excludeFilters 属性，灵活控制扫描范围，例如仅包含特定注解的类或排除某些包。

---

二、主要属性解析

属性	默认值	说明
value / basePackages	空	指定扫描的包路径（字符串或数组形式），如 @ComponentScan("com.example")。
basePackageClasses	空	根据指定类的包路径扫描其所在包及子包，如 @ComponentScan(basePackageClasses = Demo.class)。
useDefaultFilters	true	是否启用默认过滤规则（扫描 @Component 等注解的类）。设为 false 时需自定义 includeFilters。
includeFilters	空	包含的过滤规则（数组），如仅扫描带有 @Service 注解的类。
excludeFilters	空	排除的过滤规则（数组），如排除 @Controller 注解的类。
lazyInit	false	是否延迟初始化扫描到的 Bean（Spring 4.1+ 支持）。

---

三、过滤规则（FilterType）

@ComponentScan 支持多种过滤类型，通过 FilterType 指定：

1. ANNOTATION
   按注解过滤，如仅扫描 @Service 注解的类：

   @ComponentScan(includeFilters = @Filter(type = FilterType.ANNOTATION, classes = Service.class))
   

2. ASSIGNABLE_TYPE
   按类或其子类过滤，如扫描 Animal 类及其子类：

   @ComponentScan(includeFilters = @Filter(type = FilterType.ASSIGNABLE_TYPE, classes = Animal.class))
   

3. CUSTOM
   自定义过滤规则，需实现 TypeFilter 接口。例如仅扫描类名含 Controller 的类：

   public class CustomFilter implements TypeFilter {
       @Override
       public boolean match(MetadataReader metadataReader, ...) {
           return metadataReader.getClassMetadata().getClassName().contains("Controller");
       }
   }
   

   配置：

   @ComponentScan(includeFilters = @Filter(type = FilterType.CUSTOM, classes = CustomFilter.class))
   

4. ASPECTJ/REGEX
   分别通过 AspectJ 表达式或正则表达式匹配类名。

---

四、使用示例

1. 基本用法

   @Configuration
   @ComponentScan("com.example.service") // 扫描指定包
   public class AppConfig {}
   

2. 多包扫描与过滤

   @ComponentScan(
       basePackages = {"com.example.dao", "com.example.controller"},
       excludeFilters = @Filter(type = FilterType.ANNOTATION, classes = Repository.class)
   )
   

3. 自定义过滤规则

   @ComponentScan(
       basePackages = "com.example",
       includeFilters = @Filter(type = FilterType.CUSTOM, classes = MyTypeFilter.class),
       useDefaultFilters = false
   )
   

4. 多规则组合（Java 8+）

   @ComponentScan(value = "com.example", excludeFilters = {
       @Filter(type = FilterType.ANNOTATION, classes = Controller.class),
       @Filter(type = FilterType.ASPECTJ, pattern = "com.example.test.*")
   })
   

---

五、高级特性

1. @ComponentScans
   若需同时配置多个 @ComponentScan（Java 8 以下使用）：

   @ComponentScans({
       @ComponentScan("com.example.module1"),
       @ComponentScan("com.example.module2")
   })
   

2. 与 Spring Boot 集成
   Spring Boot 的 @SpringBootApplication 已内置 @ComponentScan，默认扫描主类所在包及子包。

3. 性能优化

   • 避免扫描过大的包范围（如 **），减少启动时间。

   • 使用 lazyInit 延迟非关键 Bean 的初始化。

---

六、常见问题与注意事项

1. 未扫描到 Bean

   • 检查 basePackages 路径是否正确。

   • 确认 useDefaultFilters 是否为 true（默认启用）。

2. 与 XML 配置冲突
   若同时使用 XML 和注解配置，需避免重复扫描同一包路径。

3. 微服务场景
   在模块化项目中，每个模块可独立配置 @ComponentScan，实现组件隔离。

---

总结

@ComponentScan 是 Spring 自动化装配的核心注解，通过灵活配置包路径和过滤规则，极大简化了 Bean 的注册与管理。合理使用其高级特性（如自定义过滤、延迟加载），可提升大型项目的开发效率和运行时性能。

---