快捷導(dǎo)航

SpringBoot配置文件優(yōu)先級用法及解讀

更新時間：2025年07月21日 09:47:34 作者：壞貓警長

SpringBoot配置優(yōu)先級按來源排序,15種類型中命令行參數(shù)最高,配置文件次之,classpath下config目錄的配置優(yōu)先級高于jar內(nèi)文件,配置中心如Nacos的配置則插入列表前端,所有配置最終存入Environment的propertySources,通過順序遍歷實現(xiàn)覆蓋

SpringBoot配置文件優(yōu)先級

SpringBoot官方文檔對配置文件優(yōu)先級有以下介紹，一共15種配置，從15到1為優(yōu)先級由高到低排列。

其中較為常用的如：11.命令行參數(shù)>5.系統(tǒng)環(huán)境變量>3.配置文件

其中3.配置文件按類型優(yōu)先級由高到低又依次是：

jar包外部指定的配置如外部的application-prod.properties/yaml

>jar包外部普通配置文件如外部的application.properties/yaml
>內(nèi)部指定配置文件 > 內(nèi)部普通配置文件

我們實際項目中經(jīng)常用高優(yōu)先級的配置來覆蓋低優(yōu)先級的配置，可以達到區(qū)分開發(fā)、測試、生產(chǎn)環(huán)境的效果：

其實以上的優(yōu)先級介紹并沒有覆蓋所有的配置文件類型和配置形式，譬如我們還可以在classpath的config目錄中放一個application.yaml，這個文件的優(yōu)先級應(yīng)該在哪個位置呢？

如果我們使用了如nacos這種配置中心，配置中心里的配置又應(yīng)該在以上優(yōu)先級的哪個位置呢？

我們可以從源碼的角度來簡單了解一下

SpringBoot對配置文件的優(yōu)先級控制。

我們項目中的各種配置在SpringBoot啟動時會被以各種方式讀取加載，雖然來源不同，但是所有的配置最終都會被保存在Environment對象的propertySources屬性中，如下圖：

來自各個地方的配置，最終都存在了這個List中，所以我們會得到一個有序的配置文件列表，其中每一個元素對應(yīng)一個配置文件。

這里注意一點，所謂的高優(yōu)先級覆蓋低優(yōu)先級這種說法是有歧義的，低優(yōu)先級的配置并不是被覆蓋了，而是也會原樣保存在這個List當(dāng)中，但是其位置會相對靠后。

然后我們很自然的就會想到，項目里獲取配置數(shù)據(jù)應(yīng)該有個通用的邏輯才對，就是順序遍歷這個List中的元素，按key查找，找到了就返回，找不到再繼續(xù)到下一個配置文件里找。

也就是如下代碼：

如果要向這個配置列表里加入配置也并不麻煩，可以參考如下代碼：

public static void main(String[] args) {
   ConfigurableApplicationContext applicationContext = SpringApplication.run(SB.class, args);
   ConfigurableEnvironment environment = applicationContext.getEnvironment();
   MutablePropertySources propertySources = environment.getPropertySources();
   Map<String, Object> lastMap = new HashMap<>();
   lastMap.put("testLast", "last");
   propertySources.addLast(new MapPropertySource("lastMap", lastMap));
   String last = environment.getProperty("testLast");
   log.info("啟動成功！");
}

所以其實一共有幾種類型的配置文件并不確定，我們可以自行增加，如果項目使用了配置中心，可以查看到其配置數(shù)據(jù)在List中的位置相對靠前，也就是為什么我們配置中心里的配置優(yōu)先級高于jar包中的配置。