Springboot的自動(dòng)配置是什么及注意事項(xiàng)
Spring Boot 的 自動(dòng)配置(Auto-configuration) 是指框架根據(jù)項(xiàng)目的依賴和應(yīng)用程序的環(huán)境自動(dòng)配置 Spring 應(yīng)用上下文中的 Bean 和組件,目的是簡(jiǎn)化開發(fā)者的配置工作。
核心概念:
自動(dòng)配置的核心在于 “約定優(yōu)于配置”(Convention over Configuration),Spring Boot 會(huì)通過一定的默認(rèn)規(guī)則,根據(jù)開發(fā)者的類路徑、依賴項(xiàng)和環(huán)境判斷需要裝配哪些 Bean,并自動(dòng)進(jìn)行配置,減少手動(dòng)編寫配置文件和代碼的復(fù)雜度。
自動(dòng)配置的關(guān)鍵特點(diǎn):
自動(dòng)加載常用組件:
- 根據(jù)類路徑中的依賴和配置自動(dòng)注冊(cè)常見的組件。例如,項(xiàng)目中有
spring-boot-starter-web依賴,Spring Boot 會(huì)自動(dòng)配置一個(gè)嵌入式的 Tomcat 服務(wù)器和常用的 MVC 組件(如DispatcherServlet)。
基于條件的配置:
- Spring Boot 通過條件注解(如
@ConditionalOnClass、@ConditionalOnMissingBean)來(lái)決定是否啟用某個(gè)自動(dòng)配置。例如,當(dāng)類路徑中存在某個(gè)數(shù)據(jù)庫(kù)驅(qū)動(dòng)且未手動(dòng)配置數(shù)據(jù)源時(shí),Spring Boot 會(huì)自動(dòng)配置一個(gè)DataSource。
可以覆蓋默認(rèn)配置:
- 如果開發(fā)者需要更改某些默認(rèn)配置,可以通過手動(dòng)配置來(lái)覆蓋。Spring Boot 允許你在配置文件(
application.properties或application.yml)中修改默認(rèn)參數(shù),或者通過手動(dòng)定義 Bean 來(lái)替換自動(dòng)配置的 Bean。
減少繁瑣配置:
- 傳統(tǒng) Spring 應(yīng)用中需要手動(dòng)編寫大量 XML 或 Java 配置類。而在 Spring Boot 中,大多數(shù)配置是自動(dòng)完成的,開發(fā)者只需關(guān)注具體業(yè)務(wù)邏輯。
自動(dòng)配置工作原理:

@EnableAutoConfiguration 注解:
- Spring Boot 的自動(dòng)配置是通過
@EnableAutoConfiguration注解來(lái)啟用的。該注解會(huì)掃描spring.factories文件(在 Spring Boot 內(nèi)部的spring-boot-autoconfigure模塊中),找到所有符合條件的自動(dòng)配置類。
spring.factories文件:
spring.factories文件中列出了所有的自動(dòng)配置類。這些類內(nèi)部通過條件注解(如@ConditionalOnClass、@ConditionalOnMissingBean)來(lái)判斷是否需要?jiǎng)?chuàng)建和配置某個(gè)組件。
條件裝配:
自動(dòng)配置類中廣泛使用了條件注解,確保只有在滿足特定條件時(shí)才會(huì)加載相關(guān)的配置和 Bean。常見的條件有:
@ConditionalOnClass:類路徑中是否存在某個(gè)類。@ConditionalOnMissingBean:上下文中是否缺少某個(gè) Bean。@ConditionalOnProperty:某個(gè)配置屬性是否被設(shè)置。
示例:
假設(shè)你正在開發(fā)一個(gè)使用數(shù)據(jù)庫(kù)的 Spring Boot 應(yīng)用。如果項(xiàng)目中加入了 spring-boot-starter-data-jpa 依賴,Spring Boot 會(huì)自動(dòng):
- 配置
DataSource(數(shù)據(jù)源) - 配置
EntityManagerFactory(實(shí)體管理工廠) - 配置
TransactionManager(事務(wù)管理器)
這些都不需要開發(fā)者手動(dòng)配置。只要項(xiàng)目的依賴中包含了必要的庫(kù),并且配置文件中提供了數(shù)據(jù)庫(kù)連接的基本信息,Spring Boot 就會(huì)自動(dòng)完成這些組件的初始化和配置。
# application.properties 示例 spring.datasource.url=jdbc:mysql://localhost:3306/mydb spring.datasource.username=root spring.datasource.password=secret
Spring Boot 的自動(dòng)配置極大地簡(jiǎn)化了 Spring 應(yīng)用的配置工作,開發(fā)者只需添加所需的依賴和最小的配置,Spring Boot 就會(huì)根據(jù)上下文自動(dòng)創(chuàng)建、配置各種常用的組件和 Bean。
這種機(jī)制能夠幫助開發(fā)者專注于業(yè)務(wù)邏輯,減少框架配置的時(shí)間成本。
需要注意的點(diǎn)
在使用 Spring Boot 自動(dòng)配置時(shí),雖然它極大地簡(jiǎn)化了配置過程,但也有一些注意事項(xiàng)和可能遇到的陷阱。以下是開發(fā)者需要注意的關(guān)鍵點(diǎn):
1.默認(rèn)配置可能不適合所有場(chǎng)景
- 問題:Spring Boot 提供的自動(dòng)配置大多是為了滿足常見的開發(fā)需求,但某些場(chǎng)景下,默認(rèn)配置可能無(wú)法滿足你的具體需求。
- 解決方案:你可以通過覆蓋配置文件或手動(dòng)定義 Bean 來(lái)調(diào)整這些配置。例如,如果默認(rèn)的數(shù)據(jù)庫(kù)連接池不合適,你可以引入你所需的連接池并手動(dòng)配置。
@Bean
public DataSource customDataSource() {
// 自定義數(shù)據(jù)源配置,覆蓋默認(rèn)的自動(dòng)配置
}2.Bean 沖突與覆蓋
- 問題:當(dāng)自動(dòng)配置的 Bean 與手動(dòng)配置的 Bean 存在沖突時(shí),手動(dòng)配置的 Bean 會(huì)優(yōu)先級(jí)更高。如果不清楚自動(dòng)配置的 Bean 會(huì)加載哪些類,可能會(huì)導(dǎo)致意外的覆蓋。
- 解決方案:使用
@ConditionalOnMissingBean等條件注解避免重復(fù)定義 Bean。你可以通過查看自動(dòng)配置類的源碼,了解它具體創(chuàng)建了哪些 Bean。
@ConditionalOnMissingBean(DataSource.class)
public class DataSourceAutoConfiguration {
// 只有在沒有手動(dòng)定義 DataSource Bean 時(shí),才會(huì)自動(dòng)配置
}3.應(yīng)用啟動(dòng)慢的問題
- 問題:Spring Boot 自動(dòng)配置在啟動(dòng)時(shí)會(huì)掃描許多類、配置,并決定要加載哪些組件。如果項(xiàng)目依賴過多或者掃描范圍太大,可能會(huì)導(dǎo)致啟動(dòng)時(shí)間變長(zhǎng)。
- 解決方案:
- 優(yōu)化類路徑依賴,去除不必要的模塊或依賴。
- 通過調(diào)整
@ComponentScan和@SpringBootApplication掃描的包范圍,避免不必要的類加載。 - 使用
spring-boot-devtools在開發(fā)過程中加快熱重啟速度。
4.過度依賴自動(dòng)配置
- 問題:過度依賴自動(dòng)配置可能會(huì)讓你對(duì)應(yīng)用內(nèi)部的配置細(xì)節(jié)缺乏掌控。一旦需要定制化時(shí),如果不了解 Spring Boot 的自動(dòng)配置機(jī)制,調(diào)試和修改將變得困難。
- 解決方案:定期檢查和理解項(xiàng)目中 Spring Boot 的自動(dòng)配置。你可以使用
spring-boot-actuator的/autoconfig端點(diǎn),查看哪些配置已啟用,哪些被禁用。
curl http://localhost:8080/actuator/conditions # 查看自動(dòng)配置詳情
5.安全性問題
- 問題:Spring Boot 自動(dòng)配置可能在未手動(dòng)定義安全措施時(shí)啟用一些不安全的默認(rèn)行為。例如,Spring Security 默認(rèn)允許 HTTP Basic 身份驗(yàn)證,可能在開發(fā)過程中泄露敏感信息。
- 解決方案:確保你了解并正確配置應(yīng)用的安全性需求。針對(duì)安全相關(guān)的自動(dòng)配置,最好進(jìn)行手動(dòng)審核和定制化配置。
# 禁用 HTTP Basic 身份驗(yàn)證 spring.security.basic.enabled=false
6.依賴沖突與版本兼容
- 問題:Spring Boot 自動(dòng)依賴管理(通過
spring-boot-dependencies管理的依賴)有時(shí)可能和你使用的庫(kù)版本沖突,導(dǎo)致兼容性問題。 - 解決方案:使用 Spring Boot 提供的依賴版本,避免直接升級(jí)依賴版本,除非明確需要。如果確實(shí)需要升級(jí)某個(gè)庫(kù)的版本,可以在
pom.xml或build.gradle中手動(dòng)排除依賴沖突。
<dependency>
<groupId>org.example</groupId>
<artifactId>example-library</artifactId>
<version>1.2.3</version>
<exclusions>
<exclusion>
<groupId>com.conflict</groupId>
<artifactId>conflicting-library</artifactId>
</exclusion>
</exclusions>
</dependency>7.過多不必要的自動(dòng)配置
- 問題:Spring Boot 自動(dòng)配置會(huì)嘗試為項(xiàng)目中的每個(gè)依賴加載相應(yīng)的配置,這可能會(huì)導(dǎo)致加載過多的 Bean 和不必要的依賴。
- 解決方案: 使用
@EnableAutoConfiguration(exclude = ...)或application.properties中的spring.autoconfigure.exclude來(lái)排除不需要的自動(dòng)配置類。精簡(jiǎn)依賴,只引入必要的模塊。
@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
public class MyApplication {
public static void main(String[] args) {
SpringApplication.run(MyApplication.class, args);
}
}8.調(diào)試?yán)щy
- 問題:由于自動(dòng)配置的存在,某些配置是動(dòng)態(tài)加載的,這使得排查問題時(shí)可能無(wú)法直接找到配置的來(lái)源,調(diào)試相對(duì)困難。
- 解決方案: 通過
spring-boot-actuator提供的conditions和beans端點(diǎn)查看 Bean 的裝配情況。開啟調(diào)試日志,可以通過配置logging.level.org.springframework=DEBUG查看 Spring Boot 啟動(dòng)過程中的自動(dòng)配置日志。
到此這篇關(guān)于什么是Springboot的自動(dòng)配置以及注意事項(xiàng)的文章就介紹到這了,更多相關(guān)Springboot的自動(dòng)配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
- Java SpringBoot自動(dòng)配置原理詳情
- Springboot自動(dòng)配置與@Configuration配置類詳解
- SpringBoot自動(dòng)配置實(shí)現(xiàn)的詳細(xì)步驟
- SpringBoot自動(dòng)配置原理詳解
- SpringBoot自動(dòng)配置Quartz的實(shí)現(xiàn)步驟
- springboot自動(dòng)配置原理以及spring.factories文件的作用詳解
- springboot自動(dòng)配置原理解析
- 淺談springboot自動(dòng)配置原理
- SpringBoot自動(dòng)配置的實(shí)現(xiàn)原理
相關(guān)文章
Springboot?RestTemplate設(shè)置超時(shí)時(shí)間的簡(jiǎn)單方法
學(xué)習(xí)springboot ,RestTemplate的使用場(chǎng)景非常非常多,比如springcloud中的服務(wù)消費(fèi),下面這篇文章主要給大家介紹了關(guān)于Springboot?RestTemplate設(shè)置超時(shí)時(shí)間的簡(jiǎn)單方法,需要的朋友可以參考下2022-01-01
servlet之web路徑問題_動(dòng)力節(jié)點(diǎn)Java學(xué)院整理
這篇文章主要為大家詳細(xì)介紹了servlet之web路徑問題的相關(guān)資料,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-07-07
詳解hibernate雙向多對(duì)多關(guān)聯(lián)映射XML與注解版
本篇文章主要介紹了詳解hibernate雙向多對(duì)多關(guān)聯(lián)映射XML與注解版,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-05-05
SpringBoot整合EasyExcel實(shí)現(xiàn)導(dǎo)入導(dǎo)出功能
EasyExcel是一個(gè)基于Java的、快速、簡(jiǎn)潔、解決大文件內(nèi)存溢出的Excel處理工具,他能讓你在不用考慮性能、內(nèi)存的等因素的情況下,快速完成Excel的讀、寫等功能,本文就給大家介紹一下SpringBoot整合EasyExcel實(shí)現(xiàn)導(dǎo)入導(dǎo)出功能的方法,需要的朋友可以參考下2023-09-09
springboot2.0.0配置多數(shù)據(jù)源出現(xiàn)jdbcUrl is required with driverClassN
這篇文章主要介紹了springboot2.0.0配置多數(shù)據(jù)源出現(xiàn)jdbcUrl is required with driverClassName的錯(cuò)誤,文中通過示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧2020-11-11
springboot 如何配置多個(gè)jndi數(shù)據(jù)源
這篇文章主要介紹了springboot 如何配置多個(gè)jndi數(shù)據(jù)源的操作,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。如有錯(cuò)誤或未考慮完全的地方,望不吝賜教2021-07-07

