关于spring中@ComponentScan注解basePackageClasses属性的坑

最新推荐文章于 2025-06-30 08:20:42 发布
最新推荐文章于 2025-06-30 08:20:42 发布
阅读量1.2w 收藏 2
点赞数 6
CC 4.0 BY-SA版权
分类专栏： java 文章标签： spring
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_33460264/article/details/84821905
博客介绍了basePackageClasses属性的扫描规则，该属性会扫描类所在包下的所有组件，而非指定某个组件。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

basePackageClasses属性会去扫描类所在包下的所有组件，而不是指定某个组件！

【Spring】Spring ： @ComponentScan注解
九师兄
01-19 553
【代码】【Spring】Spring ： @ComponentScan注解。
第六节：如何解决@ComponentScan只能扫描当前包及子包（自学Spring boot 3.x的第一天）
Mero技术博客
06-28 926
继上节咱们使用了@Component和@ComponentScan的方法实现了获取IOC容器中的Bean，但是存在一个问题，就是必须把AppConfig和要扫描的bean类放在同一个目录下，这样就导致了AppConfig类和bean类在同一个目录下，这对整个项目的结构框架来说是不合理的，没有人会这样做，所以config包和pojo包就应该分开。通过上面的方式虽然可以实现，但是如果bean来太多了，就麻烦了。3. 在@ComponentScan后面紧跟要扫描的包，这样会自动扫描下面的类。
spring应用手册-IOC（注解实现）-(24)-@ComponentScan注解的basePackageClasses 属性
10-09 877
戴着假发的程序员出品 抖音ID：戴着假发的程序员 欢迎关注 @ComponentScan注解的basePackageClasses 属性 spring应用手册（第二部分） basePackageClasses 用来指定某个类所在包下的所有组件。springboot中的主应用类就是一个BasePackageClass。 看案例： 我们准备如下结构的类： 其中每个类源码： Person类：
【spring】@ComponentScan详解&@SpringBootApplication的scanBasePackages属性
weixin_46161383的博客
12-07 5790
spring注解
@ComponentScan 和 @ComponentScans 详解及详细源码展示
最新发布
csdn_tom_168的博客
06-30 942
Spring 框架中的 @ComponentScan 和 @ComponentScans 注解用于组件扫描，将特定注解标记的类注册为 Spring Bean。@ComponentScan 定义单个扫描配置，支持路径、过滤规则等设置；@ComponentScans 是其复数形式，允许组合多个扫描配置。源码解析显示，@ComponentScan 提供包路径、过滤器和加载策略等精细控制，而 @ComponentScans 通过数组形式容纳多个扫描规则。Spring 容器启动时，会解析这些注解，创建扫描器执行任务，
SpringBoot教程(8) @ComponentScan注解 value basePackageClasses 详细讲解
Java Spring Elasticsearch
03-18 7522
@ComponentScan注解 excludeFilters FilterType过滤器 详细讲解一、@ComponentScan用法介绍1. value和basePackages 一、@ComponentScan用法介绍 @ComponentScan很多人都知道它是用来扫描知道包路径下的组件，并把它们注册到Spring容器中。 @ComponentScan它看着挺简单，但是它有很多参数，功能很强大，其中有很多细节需要注意。 下面我讲由浅入深地介绍@ComponentScan。 1. value和base
@ComponentScan 注解
2301_76607156的博客
03-29 4666
/ basePackages 的别名// 在没有其他属性的情况下可以如此写：@ComponentScan("com.cxyxj.componentscan")// 而不需要：@ComponentScan(basePackages = "com.cxyxj.componentscan")// 扫描带注解的包路径，默认是@Component// 扫描指定带注解的类，同时会扫描该类所在的包，默认是@Component。
解决在spring配置文件中包扫描无效问题
lkwan123的博客
07-23 1万+
自己写的一个小项目，用的框架ssm整合，里面明明配置了包扫描，但是就出现了这个异常 org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'adminPersonController': Injection of autowired dependencies failed; n
Spring Framework @ComponentScan注解
一起coding，一起嗨。
08-01 456
Spring Framework @ComponentScan注解
Spring进阶（十三）之你真的懂@ComponentScan注解吗
weixin_56644618的博客
10-06 1122
@ComponentScan注解详解
Spring Boot中@ComponentScan与@EnableAutoConfiguration的协同使用
m0_74337424的博客
02-04 866
然而，仅使用@EnableAutoConfiguration是不够的，我们还需要@ComponentScan注解来扫描项目中的组件（如@Component、@Service、@Controller等），以便Spring能够将它们注册为Bean。在Spring Boot应用开发中，组件扫描（@ComponentScan）和自动配置（@EnableAutoConfiguration）是两个非常重要的特性。@ComponentScan：启用组件扫描，扫描当前类所在的包及其子包中的组件。
@ComponentScan
judicator0301的博客
07-14 3723
@ComponentScan 作用 @ComponentScan用于批量注册bean。 这个注解会让spring去扫描某些包及其子包中所有的类，然后将满足一定条件的类作为bean注册到spring容器中。 具体需要扫描哪些包？以及这些包中的类满足什么条件时被注册到容器中，这些都可以通过这个注解中的参数动态配置。 常用参数 value：指定需要扫描的包，如：com.javacode2018 basePackages：作用同value；value和basePackages不能同时存在设置，可二选一 base
basePackage和basePackageClasses区别
qq_50958006的博客
04-26 711
也可以考虑在包中创建一个用来进行扫描的空标记接口（markerinterface）。通过标记接口的方式，能够保持对重构友好的接口引用，但是可以避免引用任何实际的应用程序代码（在稍后重构中，这些应用代码有可能会从想要扫描的包中移除掉）。将其指定为包中所包含的类或接口，这些类所在的包将会作为组件扫描的基础包。即会去扫描basePackageClasses类指定类或接口所在包下的所有组件，而不是指定某个组件！文心一言、《Spring实战》（第四版）
为什么@ComponentScan不设置basePackage也会扫描
小泽
11-02 377
spring
【SpringBoot程序中最重要的注解@SpringBootApplication】
weixin_28140939的博客
03-02 230
使用@SpringBootApplication注解时这个注解自动开启。推断简省了用户的手工配置，如果某个推断的默认配置不是你习惯的使用类的bean，也可以自己定义，也就是说某个特性的实现beans有用户定义的用用户定义的，用户没有定义的用推断的。@ComponentScan注解指示扫描配置类（@Configuration注解的class）, 可以用#basePackageClasses或#basePackages指明扫描特定的包，如果没有指明则中带@ComponentScan注解的类所在包开始扫描。
（新手勿进，全是代码）@ComponentScan、@ComponentScans详解
2401_83384536的博客
03-15 2784
xml中bean元素的方式@Bean注解标注方法的方式通常情况下，项目中大部分类都需要交给spring去管理，按照上面这2种方式，代码量还是挺大的。为了更方便bean的注册，Spring提供了批量的方式注册bean，方便大量bean批量注册，spring中的@ComponentScan就是干这个事情的。@Component@Component//@3重点在于@1和@2这2个地方的代码，通过上面的参数可以间接给@Component注解中的value设置值。
那些年我们遇到的坑（3）-basePackages和scanBasePackages
热门推荐
l1h2l3的博客
06-20 5万+
1.SpringBootApplication启动时会默认扫描主类当前包及子包，如果需要扫描主类当前包外的其他包或不扫描当前包下的特定包或类，可通过下列属性实现：Class<?>[] exclude() default {}; String[] excludeName() default {}; String[] scanBasePackages() default {}; Class<?>[] s
如何让spring扫描主类当前包外的其他jar包 --- scanBasePackages 应用
天天的专栏
11-27 6137
自己开发一个jar，想给其他项目直接调用。 都是springboot工程，jar包里有有些类带了spring的注解，系统能被加载到spring中。 之前也这样用过，没有发现什么问题，这次发现pom引用了，程序中编译也没有问题，但是springboot启动以后不加载。jar中的bean。 最后找到了问题的根本原因： SpringBootApplication启动时会默认扫描主类当前包及子包，...
Spring系列第18篇：@ComponentScan、@ComponentScans详解(bean批量注册)
GitHub质检员
08-25 1028
到目前为止，介绍了2种注册bean的方式：xml中bean元素的方式@Bean注解标注方法的方式通常情况下，项目中大部分类都需要交给spring去管理，按照上面这2种方式，代码量还是挺大的。为了更方便bean的注册，Spring提供了批量的方式注册bean，方便大量bean批量注册，spring中的@ComponentScan就是干这个事情的。
@ComponentScan注解
05-10
### Spring @ComponentScan 注解 使用说明及常见问题解决方案 #### 一、@ComponentScan 注解概述 `@ComponentScan` 是 Spring 框架中的一个重要注解，主要用于自动扫描指定包及其子包下的类，并将其注册为 Spring 容器中的 Bean。默认情况下，Spring Boot 项目会基于 `@SpringBootApplication` 注解所在的包路径进行扫描，但如果需要自定义扫描范围，则可以通过 `@ComponentScan` 显式指定[^1]。 - **核心功能**：扫描带有特定注解（如 `@Component`、`@Service`、`@Repository` 和 `@Controller` 等）的类，并将它们注册为 Spring 容器中的 Bean。 - **注意事项**：如果目标类是接口而非具体实现类，即使标注了 `@Component` 注解，也无法被实例化为 Bean，因为接口本身无法直接实例化[^2]。 --- #### 二、@ComponentScan 的常用属性 以下是 `@ComponentScan` 注解的一些重要属性及其作用： 1. **basePackages** - 类型：字符串数组 (`String[]`) - 描述：指定需要扫描的包名列表。例如： ```java @ComponentScan(basePackages = {"com.example.package1", "com.example.package2"}) ``` 2. **basePackageClasses** - 类型：Class 数组 (`Class<?>[]`) - 描述：通过指定某些类来间接确定扫描的包路径。这些类所在的包会被作为根目录进行扫描。例如： ```java @ComponentScan(basePackageClasses = {MyClass1.class, MyClass2.class}) ``` 3. **useDefaultFilters** - 类型：布尔值 (`boolean`) - 描述：控制是否启用默认过滤规则，默认值为 `true`。如果设为 `false`，则需要显式定义过滤条件。 4. **includeFilters/excludeFilters** - 类型：Filter 数组 (`Filter[]`) - 描述：用于定义包含或排除的过滤规则。支持多种类型的过滤器，如按注解、类类型等筛选。例如： ```java @ComponentScan( includeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = Controller.class), useDefaultFilters = false ) ``` 5. **resourcePattern** - 类型：字符串 (`String`) - 描述：定义扫描时匹配的资源模式，默认为 `/**/*.class`，即扫描所有 `.class` 文件。 --- #### 三、典型应用场景与代码示例 ##### 场景 1：覆盖默认扫描路径 当项目的包结构较为复杂，或者需要引入外部 jar 包中的组件时，可以使用 `@ComponentScan` 来扩展扫描范围。例如： ```java @ComponentScan(basePackages = {"com.external.lib", "com.myapp.service"}) public class AppConfig { } ``` ##### 场景 2：多重扫描不同包路径 有时需要同时扫描多个不相关的包路径，可通过重复使用 `@ComponentScan` 或利用 `@Repeatable` 特性完成。例如： ```java @ComponentScan("com.pwx.bean") @ComponentScan("com.pwx.bean1") public class MyConfig { public static void main(String[] args) { AnnotationConfigApplicationContext applicationContext = new AnnotationConfigApplicationContext(MyConfig.class); String[] beanDefinitionNames = applicationContext.getBeanDefinitionNames(); Arrays.stream(beanDefinitionNames).forEach(System.out::println); } } ``` 注意：上述写法在现代版本中可能更推荐使用 `@ComponentScans` 组合形式[^3]。 ##### 场景 3：定制化过滤规则 假设只希望扫描带 `@Controller` 注解的类，可配置如下： ```java @ComponentScan( basePackages = "com.myapp", includeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = Controller.class), useDefaultFilters = false ) public class WebAppConfig { } ``` --- #### 四、常见问题及解决方法 1. **问题**: 引入第三方库后，部分 Bean 未被扫描到。 - **原因**: 默认扫描路径仅限于启动类所在包及其子包。 - **解决办法**: 使用 `@ComponentScan` 扩展扫描范围至目标包路径[^5]。 2. **问题**: 控制器类未被识别，导致 HTTP 请求返回 404 错误。 - **原因**: 启动类所在包之外的控制器类未被纳入扫描范围。 - **解决办法**: 确保 `@ComponentScan` 正确指定了包含控制器类的包路径。 3. **问题**: 接口类加了 `@Component` 注解却未能成为 Bean。 - **原因**: 接口无法直接实例化。 - **解决办法**: 提供具体的实现类并为其添加相应注解[^2]。 --- ### 总结 `@ComponentScan` 是一个强大的工具，可以帮助开发者灵活地管理 Spring 应用中的组件扫描行为。合理配置其属性能够显著提升开发效率，同时也需留意潜在陷阱以避免不必要的错误发生。 ---
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值