springBoot項(xiàng)目配置文件加載優(yōu)先級及同配置覆蓋問題詳解
背景:
由于目前網(wǎng)上對于springboot配置文件的加載問題,存在著各種不同的說法。所以導(dǎo)致自己不敢確定到底何種結(jié)論才是真正正確的,故專門花費(fèi)了一些時(shí)間進(jìn)行親自驗(yàn)證。
驗(yàn)證:
在經(jīng)過自己對配置文件的加載問題進(jìn)行驗(yàn)證后,發(fā)現(xiàn)所謂配置文件的優(yōu)先級并不一定是固定不變的,而是會受一些前提條件的影響。下面將對bootstrap.properties、bootstrap.yml、application.properties、application.yml這四種我們可能使用到的配置文件的加載優(yōu)先級問題進(jìn)行詳細(xì)的說明(此處以springCloud微服務(wù)項(xiàng)目為背景,不然單純的springBoot項(xiàng)目是不會加載bootstrap配置文件的,且以下說明默認(rèn)配置文件都是在同一目錄)。
一.非活動的profile
首先,在默認(rèn)的情況下也就是不存在活動的profile(即不指定spring.profiles.active=?)時(shí),四種文件的加載優(yōu)先級依次為bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml。感興趣可以在源碼上打斷點(diǎn)可以得知配置文件的加載分為兩次,如圖所示:
第一次是bootstrap(.properties/.yml)的加載:

以此得出加載優(yōu)先級bootstrap.properties -> bootstrap.yml
第二次是application(.properties/yml)的加載:

以此得出application.properties -> application.yml。
總結(jié):bootstrap的配置先于application的配置加載,同時(shí).properties的加載又先于.yml的加載,即加載優(yōu)先級bootstrap.properties -> bootstrap.yml -> application.properties -> application.yml。
需要注意的是:
1.當(dāng)同一個(gè)配置屬性在bootstrap.properties和bootstrap.yml文件中都存在時(shí),那么properties中的配置會被加載,而忽略yml文件中的配置(即優(yōu)先級高的配置覆蓋優(yōu)先級低的配置),不同配置相互互補(bǔ)。此處application(.properties/yml)同理。
2.但當(dāng)同一配置在bootstrap.properties和application.properties中都存在時(shí),那么雖然優(yōu)先加載bootstrap.properties但是會被applicatioin.properties中的配置覆蓋,此時(shí)則變成了低優(yōu)先級覆蓋高優(yōu)先的配置,所以網(wǎng)上很多文章所說的高優(yōu)先級覆蓋低優(yōu)先級其實(shí)是不嚴(yán)謹(jǐn)?shù)摹?/p>
3.不同的配置會進(jìn)行互補(bǔ)操作,即SpringBoot會讀取全部的配置文件,加載所有不同的配置項(xiàng),匯成一個(gè)總的配置。
二、活動的profile
例如在指定了spring.profiles.active=dev/test/prod此類時(shí),即有了活動的profile時(shí),加載優(yōu)先級便會發(fā)生變化此時(shí)活動的優(yōu)先級最高,還是直接上圖:

指定profile為dev

配置文件如上
看一下加載順序變成怎么樣的了,同樣第一次先加載bootstrap:

第二次加載application:

綜上此時(shí)的加載優(yōu)先級變?yōu)榱薭ootstrap-dev.yml -> bootstrap.properties -> application-dev.yml ->application.properties。且同屬性配置的覆蓋問題和之前一樣,在同為bootstrap或同為application的情況下,優(yōu)先級高的覆蓋優(yōu)先級低的。但當(dāng)同時(shí)存在bootstrap和application時(shí)后者仍會覆蓋前者中的配置。
舉例1:假如此時(shí)只有bootstrap-dev.yml 和bootstrap.properties且存在相同配置,則使用bootstrap-dev.yml中的配置,此時(shí)遵循高優(yōu)先級覆蓋低優(yōu)先級。
舉例2:假如此時(shí)有bootstrap-dev.yml 、bootstrap.properties及application.properties且存在相同配置,則使用application.properties中的配置,遵循application覆蓋bootstrap原則,同樣此時(shí)變成了低優(yōu)先級覆蓋高優(yōu)先級。
三、使用外部配置
如項(xiàng)目使用nacos做配置中心,則存在相同配置時(shí)以nacos中配置為主(在沒有開啟本地覆蓋nacos遠(yuǎn)程配置的情況下),nacos中的配置將會覆蓋一切本地相同的配置,不同配置可以和本地進(jìn)行互補(bǔ)。
擴(kuò)展nacos開啟本地覆蓋遠(yuǎn)程配置
如果需要啟動參數(shù)或者本地配置覆蓋遠(yuǎn)程配置,那么需要在遠(yuǎn)程配置里配置上允許重寫:
spring.cloud.config.allowOverride=true
但這是不夠的,盡管它開啟了總開關(guān),但是還有兩個(gè)默認(rèn)的小開關(guān)卡住了。
應(yīng)同時(shí)添加如下配置:
spring.cloud.config.overrideNone=true spring.cloud.config.overrideSystemProperties=false
第一個(gè)開關(guān)是遠(yuǎn)端不覆蓋本地?true 是的不覆蓋。
第二個(gè)開關(guān)是遠(yuǎn)端是否覆蓋系統(tǒng)配置?false 不覆蓋。 (默認(rèn)為true 覆蓋)
請注意,第一個(gè)小開關(guān)包括第二個(gè)。
overrideNone = true的話會開啟所有包括本地配置和系統(tǒng)配置并忽略掉overrideSystemProperties配置。
如果只想開啟overrideSystemProperties,那么就是overrideNone = false,overrideSystemProperties=false。
總結(jié)
到此這篇關(guān)于springBoot項(xiàng)目配置文件加載優(yōu)先級及同配置覆蓋問題的文章就介紹到這了,更多相關(guān)springBoot配置文件加載優(yōu)先級內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
springboot配置文件中敏感數(shù)據(jù)(賬號密碼)加密方式
這篇文章主要介紹了springboot配置文件中敏感數(shù)據(jù)(賬號密碼)加密方式,具有很好的參考價(jià)值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2024-04-04
feign遠(yuǎn)程調(diào)用無法傳遞對象屬性405的問題
這篇文章主要介紹了feign遠(yuǎn)程調(diào)用無法傳遞對象屬性405的問題,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2022-03-03
Java中調(diào)用第三方接口的幾種方法詳細(xì)指南
在Java開發(fā)中調(diào)用第三方接口是常見需求,本文介紹如何使用Java進(jìn)行接口調(diào)用,重點(diǎn)講解HttpURLConnection類、OkHttp庫和ApacheHttpClient的使用,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-10-10
一個(gè)Java工程師超實(shí)用的17個(gè)日常效率工具
這篇文章主要總結(jié)介紹了一個(gè)Java工程師超實(shí)用的17個(gè)日常效率工具,中包含了大多數(shù)開發(fā)人員已經(jīng)使用、正在使用或?qū)硪欢〞玫降母咝Чぞ?每個(gè)工具都給出了詳細(xì)的代碼示例,需要的朋友可以參考下2026-03-03
Swagger2不被SpringSecurity框架攔截的配置及說明
這篇文章主要介紹了Swagger2不被SpringSecurity框架攔截的配置及說明,具有很好的參考價(jià)值,希望對大家有所幫助。如有錯誤或未考慮完全的地方,望不吝賜教2023-03-03

