Bean 注入失败问题汇总

程序员的成长之路

共 5976字,需浏览 12分钟

 ·

2023-03-11 05:05

程序员的成长之路
互联网/程序员/技术/资料共享 
关注


阅读本文大概需要 5 分钟。

来自:blog.csdn.net/qq_51439643/article/details/124781526

目录

  • 错误案例
    • 常见情况一:bean 没有被扫描
    • 常见情况二:多模块架构 bean 没有被扫描
    • 常见情况三:使用@Qualifier 或 @Resource 注入时指定的 name 不存在
    • 常见情况四:在拦截器或过滤器或监听器中注入 bean
  • 使用 IDEA 工具查看 IOC 容器

错误案例

常见情况一:bean 没有被扫描

常见问题
SpringBoot项目启动时,会默认自动扫描启动类所在的包以及子包下的Bean。
例如下面的这种情况:
项目希望在 com.training 包下放置主函数与服务代码,在 com.utils 包下放置一些配置与工具类。
因为启动类所在的包是:com.training,所以在com.training包与其子包下的 Bean 会被默认自动扫描加入到 Spring 容器中。
而 com.utils 包不包含在默认扫描的包之内,就算是将 bean1 对象使用注解尝试注入容器,Spring 也不会扫描到该类,因此这是大部分 bean 注入失败的原因。
解决方法
Spring 默认扫描的是启动类所在的包,为了将 com.utils 包加入到扫描中,可以使用 @ComponentScan 指定额外的扫描包,配置如下:

package com.training;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.ComponentScan;

@SpringBootApplication
// 将com.utils 包加入到 Spring 扫描范围中
@ComponentScan(basePackages = {"com.training","com.utils"})
@MapperScan(basePackages = "com.training.dao")
public class MusicMainClass {
public static void main(String[] args) {
ConfigurableApplicationContext run = SpringApplication.run(MusicMainClass.classargs);
}
}

需要注意的是:指定 @ComponetScan 后默认的扫描位置会发生改变,因此添加新的扫描包后要确保启动类所在的包也能被扫描到!
不仅仅可以使用 @ComponentScan 进行配置,@SpringBootApplication 中的 scanBasePackages 属性指定也能起到同样的作用,配置方式如下:

package com.training;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.ComponentScan;

// 使用 scanBasePackages 属性同样能够实现
@SpringBootApplication(scanBasePackages = {"com.training","com.utils"})
@MapperScan(basePackages = "com.training.dao")
public class MusicMainClass {
public static void main(String[] args) {
ConfigurableApplicationContext run = SpringApplication.run(MusicMainClass.classargs);
}
}

常见情况二:多模块架构 bean 没有被扫描

常见问题
多模块架构中 bean 无法注入常见问题与情况一相同,都是忽略了 SpringBoot 默认扫描启动类所在包下的 bean。
例如如下的架构:
因为子模块中包路径为 com.common.* ,而启动类所在的包路径为:com.training.* ,因此子模块中的 bean 无法被 Spring 自动扫描到。
解决方法
与情况一同理,指定 @ComponentScan 或 ScanbasePackages 属性,这里不过多赘述。

常见情况三:使用@Qualifier 或 @Resource 注入时指定的 name 不存在

bean名称默认规则
使用 Spring 的注解 @Component@Repository@Service@Controller 去把一个类配置为bean时,如果不指定bean的名称,那么 bean 的名称的默认规则是:
  • 类名的首字母小写,例如:类名称 UserDao ,那么默认的bean名称 userDao

  • 如果类名前两个(或两个以上)连续的字母都是大写,那么默认的bean名称与类名一样,例如:类名称 MIXDao ,那么默认的bean名称 MIXDao

使用 SpringBoot 的注解 @Bean + @Configuration 注入 bean 时,如果不指定 bean 的名称,那么 bean 的名称默认规则是:bean 名称与注入的方法名同名
简述@Qualifer注解
@Autowired 注解能够自动注入同类型的 bean,但如果与该属性同类型的 bean 不止一个存在时,Spring 无法判断具体注入哪个 bean ,@Qualifer 注解就能够解决这样的歧义。
@Qualifer 能够指定 value 字段指定需要注入 bean 的名称,通过指定名称来指定 Spring 到底应该注入哪一个 bean ,这样就能消除歧义,例如下面的例子:

public class Teacher{    
@Autowired    
private Student student;

定义一个对象 Teacher 其中包含一个 Student 字段的对象

<bean id="teacher" class="com.test.Teacher"/>

# 下面有两个相同类型不同 name 的 Student bean
<bean id="student1"class="com.test.Student">
<property name="name"value="zhangsan"/>
</bean>

<bean id="student2"class="com.test.Student">
<property name="name"value="lisi"/>
</bean>

在 xml 文件中配置上述 bean ,此时如果直接注入 Student 那么程序就会报错,因为 @Autowired 注解产生了歧义,因此需要使用 @Qualifer 注解消除歧义:

public class Teacher{    
@Qualifer(value = "student1")
@Autowired    
private Student student;

简述 @Resource 注解
@Resource 注解默认通过 名称 进行注入,名称可以通过 name 属性进行指定,如果没有指定name属性,当注解写在字段上时,默认取字段名进行安装名称查找,如果注解写在setter方法上默认取属性名进行装配。当找不到与名称匹配的bean时才按照类型进行装配。
但是需要注意的是,如果name属性一旦指定,就只会按照名称进行装配。
常见问题
知道了 bean 的默认命名规则与指定名称的两个注入注解后,可以试着查看注入的 bean 是否出现歧义,如果出现可以使用 @Qualifer 注解进行限定。
同时使用上述的两个注解之前,需要确保 IOC 容器中存在指定的 bean ,如果没有相应的 bean 也会出现注入失败的情况!

常见情况四:在拦截器或过滤器或监听器中注入 bean

叨叨两句
这两天在写项目,这个问题也是困扰了我很久很久(十几个小时至少)。
在项目中需要集成 SpringBoot + SpringSecurity 做认证授权处理,确定注入的 bean 能够被 Spring 扫描到,同时在 Controller、Service 层的注入也没有问题,但是在用户授权过滤器 UsernamePasswordAuthenticationFilter 中死活就是注入不了 bean。
开始查阅了大量的博客资料也根本没有往过滤器这方面来思考,在不断地折磨后最终还是找到了问题的所在。
常见问题
在 WebMVC 框架中,各个元素的加载是有一定顺序的,这个顺序按照:

context-param–>listener–>filter–>servlet --> … -> Bean 的实例化

而拦截器是在Spring MVC中配置的,如果从整个项目中看,一个servlet请求的执行过程就变成了这样:

context-param–>listener–>filter–>servlet–>interceptor(指的是拦截器) --> … -> Bean 的实例化

因此上述元素中注入 bean 时,bean 对象的实例化还没有开始,因此注入的值永远为 null 值!
解决方法
上述对象时,使用实例化的方式配置或是将需要注入的对象注入配置类中,在配置类中使用构造函数实例化对象,例如下面的方式:
使用构造函数:
将需要注入的对象在配置类中注入,并将其传入构造函数参数进行实例化:

使用 IDEA 工具查看 IOC 容器

众所周知 idea 作为 java 程序员的一大利器,其功能相当的强大,今天也是在苦恼于 bean 注入失败原因时,发现了IDEA支持查看 IOC 容器的功能,有了这一功能以后再遇上 bean 注入失败时就能够更快地找到失败原因了!
使用
当启动 SpringBoot 项目后点击下方的 Run 按钮(Debug 启动方式点击 Debug 按钮):
点击 Console 栏上方的 Actuator :
进入下面的页面后点击 Beans 与 Application :
可以看到右方出现了 IOC 容器中的所有 bean 数据信息:
有了这一利器就再也不怕 bean 无法注入的问题了!
<END>

推荐阅读:

Jenkins+Docker 实现一键自动化部署项目!步骤齐全,少走坑路

终于搞懂了 @Configuration 和 @Component 的区别

互联网初中高级大厂面试题(9个G)

内容包含Java基础、JavaWeb、MySQL性能优化、JVM、锁、百万并发、消息队列、高性能缓存、反射、Spring全家桶原理、微服务、Zookeeper......等技术栈!

戳阅读原文领取!                                  朕已阅 

浏览 30
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报