當心!請不要在SpringBoot中再犯這樣嚴重的錯誤
環(huán)境:SpringBoot3.3.0
1. 簡介
在Spring Boot中,@Configuration注解用于聲明配置類,以定義和注冊Bean對象。這些Bean對象可以是普通的業(yè)務組件,也可以是特殊的處理器,如BeanPostProcessor或BeanFactoryPostProcessor,用于在Spring容器中對其他Bean進行額外的處理。接下來我們將詳細的介紹關于在SpringBoot環(huán)境下各種不正確的配置導致的各種問題。
2. 實戰(zhàn)案例
2.1 循環(huán)依賴錯誤
當我們在一個配置類中使用@PostConstruct注解并且在其方法內(nèi)部去引用其它Bean時,將會出現(xiàn)循環(huán)依賴錯誤,如下示例:
@Configuration
public class AppConfig {
@PostConstruct
public void init() {
dao() ;
System.out.println("AppConfig init...") ;
}
@Bean
DAO dao() {
return new DAO() ;
}
}
在init()方法中調(diào)用dao()方法后,將無正確的啟動SpringBoot,拋出如下錯誤
圖片
循環(huán)依賴錯誤,導致該錯誤的原因是非靜態(tài)@Bean方法在語義上需要一個完全初始化的配置類實例來調(diào)用;簡單點說就是在調(diào)用dao方法時需要完全的初始化AppConfig類,但是@PostConstruct注解的方法在執(zhí)行時當前的這個AppConfig并沒有完全的執(zhí)行完成。要解決該問題可以通過如下2種方式:
方式1:
開啟循環(huán)依賴
spring:
main:
allow-circular-references: true
從SpringBoot2.6+開始默認不允許循環(huán)依賴。這樣SpringBoot程序就能正確啟動,不過這不是最好的方式也不推薦該種方式。
方式2:
將上面的dao方法聲明為static方法;
@Bean
public static DAO dao() {
return new DAO() ;
}
static修飾的方法不需要包裹它的配置類提起初始化完成。這也是最為推薦的方法。
2.2 自定義處理器錯誤
當通過 @Bean 定義 BeanPostProcessor 和 BeanFactoryPostProcessor 時可能導致當前配置依賴注入的bean將不會生效(也就是@Autowired和@Value注解可能沒有生效),如下示例:
@Configuration
public class AppConfig {
@Value("${pack.title}")
private String title ;
@Override
public String toString() {
return "AppConfig [title=" + title + "]";
}
}
配置文件中配置信息;
pack:
title: xxxooo
控制臺輸出
AppConfig [title=xxxooo]
沒有問題;但是如果你在AppConfig配置類中注冊BeanPostProcessor后會出現(xiàn)什么情況呢?
自定義BeanPostProcessor;
public class PackBeanPostProcessor implements BeanPostProcessor {
// TODO
}
通過@Bean注冊上面的BeanPostProcessor;
@Bean
public PackBeanPostProcessor packBeanPostProcessor() {
return new PackBeanPostProcessor() ;
}
再次運行服務,控制臺輸出
AppConfig [title=xxxooo]
還是能正確的輸出!?注意接下來我們對上面的自定義處理器做如下修改;
public class PackBeanPostProcessor implements BeanPostProcessor, PriorityOrdered {
// TODO
@Override
public int getOrder() {
return -1 ;
}
}
這時候我們?nèi)崿F(xiàn)了PriorityOrdered優(yōu)先級接口,并將優(yōu)先級設置的比較的高。如上調(diào)整后再次啟動服務
AppConfig [title=null]
問題出現(xiàn)了配置的屬性并沒有正確的解析注入,這是因為在默認情況下處理@Value注解的處理器的優(yōu)先級低于你當前自定義處理器的優(yōu)先級,所以這就導致了問題。同樣的如果你使用@Autowired或@Resource也將會導致問題,如下示例:
@Configuration
public class AppConfig {
@Resource
private Person person ;
}
輸出結果:
AppConfig [persnotallow=null]
同樣不能被注入;
要解決該問題可以通過如下2種方式:
方式1:
通過實現(xiàn)ApplicationContextInitializer接口;
public class PackApplicationContextInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {
@Override
public void initialize(ConfigurableApplicationContext context) {
context.getBeanFactory().addBeanPostProcessor(new PackBeanPostProcessor());
}
}
注冊該實現(xiàn);
org.springframework.context.Applicatinotallow=\
com.pack.PackApplicationContextInitializer
這種方式實現(xiàn)非常麻煩;推薦下面的第二種方式
方式2:
將@Bean對應的方法聲明為static即可。
@Bean
public static PackBeanPostProcessor packBeanPostProcessor() {
return new PackBeanPostProcessor() ;
}
將該方法聲明為static后,那么容器在獲取BeanPostProcessor是不需要先實例化包裹它的類的實例。
其實對于@Configuration注解的配置類,如果你有需要注入的對象,官方建議采用參數(shù)的方式注入,如下示例:
@Configuration
public class AppConfig {
private final Person person ;
public AppConfig(Person person) {
this.person = person ;
}
}
構造函數(shù)注入也是在任何形式下的推薦注入方式。