【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象

大家好呀我是秋刀鱼~

最近写项目时遇到了很多关于 Spring 注入 bean 的问题,也是耗费了我很多时间去查找注入失败的原因。因此这篇博客就来总结一下 bean 注入失败的常见情况,希望能对你有所帮助


博客主页:秋刀鱼与猫__

如果觉得博主写的还不错的话,还请大家关注、三连支持一下博主~

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第1张图片

目录

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


错误案例

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

常见问题

SpringBoot项目启动时,会默认自动扫描启动类所在的包以及子包下的Bean。

例如下面的这种情况:

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第2张图片

项目希望在 com.training 包下放置主函数与服务代码,在 com.utils 包下放置一些配置与工具类。

因为启动类所在的包是:com.training,所以在com.training包与其子包下的 Bean 会被默认自动扫描加入到 Spring 容器中。

com.utils 包不包含在默认扫描的包之内,就算是将 bean1 对象使用注解尝试注入容器,Spring 也不会扫描到该类,因此这是大部分 bean 注入失败的原因。

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第3张图片

解决方法

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.class, args);
}
}

需要注意的是:指定 @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.class, args);
}
}

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

常见问题

多模块架构中 bean 无法注入常见问题与情况一相同,都是忽略了 SpringBoot 默认扫描启动类所在包下的 bean。

例如如下的架构:

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第4张图片

因为子模块中包路径为 com.common.* ,而启动类所在的包路径为:com.training.* ,因此子模块中的 bean 无法被 Spring 自动扫描到。

解决方法

与情况一同理,指定 @ComponentScanScanbasePackages 属性,这里不过多赘述。

常见情况三:使用@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。

开始查阅了大量的博客资料也根本没有往过滤器这方面来思考,在不断地折磨后最终还是找到了问题的所在。

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第5张图片

常见问题

在 WebMVC 框架中,各个元素的加载是有一定顺序的,这个顺序按照:

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

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

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

因此上述元素中注入 bean 时,bean 对象的实例化还没有开始,因此注入的值永远为 null 值!

解决方法

上述对象时,使用实例化的方式配置或是将需要注入的对象注入配置类中,在配置类中使用构造函数实例化对象,例如下面的方式:

使用构造函数:

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第6张图片

将需要注入的对象在配置类中注入,并将其传入构造函数参数进行实例化:

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第7张图片

✨ 使用 IDEA 工具查看 IOC 容器

众所周知 idea 作为 java 程序员的一大利器,其功能相当的强大,今天也是在苦恼于 bean 注入失败原因时,发现了IDEA支持查看 IOC 容器的功能,有了这一功能以后再遇上 bean 注入失败时就能够更快地找到失败原因了!

使用

  • 当启动 SpringBoot 项目后点击下方的 Run 按钮(Debug 启动方式点击 Debug 按钮):

  • 点击 Console 栏上方的 Actuator

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第8张图片

进入下面的页面后点击 BeansApplication

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第9张图片

可以看到右方出现了 IOC 容器中的所有 bean 数据信息:

【SpringBoot】Bean 注入失败问题汇总 —— 情人节让Spring教你如何找到对象_第10张图片

有了这一利器就再也不怕 bean 无法注入的问题了!

你可能感兴趣的:(spring,spring,boot,java)