SpringBoot内外部配置文件加载和优先级

迷南。 2023-02-18 14:18 109阅读 0赞

## 一、简介 ##

**前言：**

**Spring**这么流星很重要的一个思想是：配置化思想。从而达到解耦的目的，很多都不需要硬编码，配置一下即可完成，可谓大大提高了编码的效率。

**Spring**支持的配置文件加载的方式繁多，一方面是扩大了灵活性，另一方面其实也带来了较大的复杂性。因此本文旨在用一篇文章解决读者朋友的烦恼，同时有时候也是你我的烦恼。

我们知道**SpringBoot**支持三种配置文件：

**application\*.yml **   
**application\*.yaml**     
**application\*.properties**

**示例：**

在 **Resources **文件夹下新建 **application.yml** 和** application.properties** 文件。

**application.properties：**

server.port=8001

**application.yml** ：

server:
      port: 7001

运行程序：

![format_png][]

通过运行结果，我们可以得出：

**这三种配置文件以** **application\*.properties ****优先级最高**，**application.properties** 和 **yml 文件在并存时（同一目录下）**，

`application.properties `**优先级更好，会先读它，若它没有，再去读yml中的值。**

下面所有的Demo代码都以 **yml **进行演示

## 二、内部的配置文件加载 ##

内部配置文件的加载都有哪些目录呢？

我们在IDE编辑器中找到类 **ConfigFileApplicationListener** 打开，发现默认扫描目录是四个：

![format_png 1][]

对应的四个目录：

<table> 
 <tbody> 
  <tr> 
   <td>path</td> 
   <td>&nbsp;</td> 
   <td>扫描优先级</td> 
  </tr> 
  <tr> 
   <td>&nbsp;./&nbsp;</td> 
   <td>项目根目录下的config目录</td> 
   <td>2</td> 
  </tr> 
  <tr> 
   <td>&nbsp;./config</td> 
   <td>项目根目录下的config目录&nbsp;</td> 
   <td>1</td> 
  </tr> 
  <tr> 
   <td>&nbsp;classPath:./</td> 
   <td>编译路径下的根目录&nbsp;</td> 
   <td>4</td> 
  </tr> 
  <tr> 
   <td>&nbsp;classPath:/config</td> 
   <td>编译路径下的config目录&nbsp;</td> 
   <td>3</td> 
  </tr> 
 </tbody> 
</table>

项目启动后扫描顺序：

*  1.  先去项目根目录找config文件夹下找配置文件件
    2.  再去根目录下找配置文件
    3.  去**resources**下找cofnig文件夹下找配置文件
    4.  去**resources**下找配置文件

以上四个目录，**SpringBoot **启动时会按照优先级从低到高的顺序，所有的配置文件都会被加载，高优先级的配置文件会覆盖低优先级的配置文件内容。

**SpringBoot **会按照四个位置全部加载配置文件，如果高优先级的配置文件属性和低优先级的配置文件属性不冲突，则会共存互补。

按照上面的目录，我们在项目中分别建立对应的文件夹和文件夹下的文件，配置文件的优先级为：

![format_png 2][]

**备注：**

**这里说的配置文件，都还是项目里面。最终都会被打进jar包里面的，需要注意。**

**1、如果同一个目录下，有 ****application.yml** **也有 application.properties，默认先读取 application.properties。**  
**2、如果同一个配置属性，在多个配置文件都配置了，默认使用第1个读取到的，后面读取的不覆盖前面读取到的。**  
**3、创建SpringBoot项目时，一般的配置文件放置在“项目的resources目录下”**

## 三、外部的配置文件加载 ##

有的时候，配置信息是我们无法在开发过程中就能确定的。比如，给客户开发的项目，客户需要根据自身的情况自定义配置，如数据库配置，加密密钥配置等等。

这时候，就需要把配置文件放在外面，让用户自定义配置部署了。

**SpringBoot  打包时不会把 ./config  ./这两级的目录打包进去。这个设计很巧妙，因为没有打包进来，所以SpringBoot可以加载外部发配置文件。**

SpringBoot 支持把配置文件放在外部。只要把配置文件放在jar包的同级目录下，或者放在同级下的**config**文件夹中，**SpringBoot**都会去此处读取配置文件。

**1、**现在有一个**SpringBoot **打包程序，（有一个配置文件 application.yml 在默认的 **Resources **文件夹下）：

** application.yml **配置信息：

server:
      port: 8001

执行命令  java -jar springboot-0.0.1-SNAPSHOT.jar  ，程序启动以后，我们可以看到启动端口是我们配置的 8001：

![format_png 3][]

** 2、**这时，我们在根目录添加配置文件 **application.properties**：

server.port=8002

![format_png 4][]

执行命令  *java -jar springboot-0.0.1-SNAPSHOT.jar  *，程序启动后，启动端口为 ***application.properties* **配置文件内配置的 **8002 **端口

![format_png 5][]

**3、**这时，我们在根目录添加文件夹和配置文件 ./config/application.properties

![format_png 6][]

server.port=8003

执行命令**  *java -jar springboot-0.0.1-SNAPSHOT.jar  ***，程序启动后，我们发现启动端口为根目录 **config**文件夹下*** application.properties*** 配置文件内配置的 **8003 **端口

![format_png 7][]

这样每次修改的时候只需要修改配置文件信息，然后重启项目就好，不需要重新打包。如果想要只修改配置文件，不重启项目就能生效，可以考虑用java来读取配置文件中的数据。

## 四、命令行配置方式 ##

比如*** ****** java -jar* **这种方式，多个属性之间用空格分开，***properties** *里的属性基本都能用，用法是属性项=属性值这种方法，举个例子：

java -jar springboot-0.0.1-SNAPSHOT.jar --server.port=8002 --server.context-path=/example

上面的命令行进行了两个配置  server.port 和 server.context-path。可以根据需要进行配置。

**如果我们外部的配置文件不想放在默认的位置**，**可使用** --spring.config.location **命令指定配置文件的目录**。

在根目录新建 **test **文件夹，把 application.properties 配置文件放入其中：

![format_png 8][]

**test**文件夹内  **application.properties** 配置文件内容：

server.port=8006

执行 下面命令行，启动项目：

java -jar springboot-0.0.1-SNAPSHOT.jar --spring.config.location=./test/application.properties

项目启动后，可以看到端口后是 **test **文件夹中 application.properties 配置文件中配置的端口，配置生效。

![format_png 9][]

原文地址：

[https://www.cnblogs.com/wwj1992/articles/12569164.html][https_www.cnblogs.com_wwj1992_articles_12569164.html]

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjUyMDE4MzgxNzYtMjE0MTY2ODE3My5wbmc?x-oss-process=image/format,png
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjUyMDUyNTc4NTUtMjAxNTk0MjM2Mi5wbmc?x-oss-process=image/format,png
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjUyMDM5MDc0MTYtNjc2MjQ3OTM3LnBuZw?x-oss-process=image/format,png
[format_png 3]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjUyMTQ4NTg5OTItMTYwMzYzMjY5Ni5wbmc?x-oss-process=image/format,png
[format_png 4]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjYxOTQwMDgwMTYtMTk0NTA2MTM0MS5wbmc?x-oss-process=image/format,png
[format_png 5]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjUyMTU0MDIwMTYtMzk5MzQ2MDgucG5n?x-oss-process=image/format,png
[format_png 6]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjYxOTQzNDY2ODMtMjQzMTY5Mzk0LnBuZw?x-oss-process=image/format,png
[format_png 7]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjYxOTQ1Mjk2NzAtMTU4Njg3OTY2MC5wbmc?x-oss-process=image/format,png
[format_png 8]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjYyMjMxMjg0NDAtMTExMzk3Njc3LnBuZw?x-oss-process=image/format,png
[format_png 9]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9pbWcyMDIwLmNuYmxvZ3MuY29tL2Jsb2cvNzU0MTkxLzIwMjAwMy83NTQxOTEtMjAyMDAzMjYyMjM0MTk0MTMtMjM2NDY4OTI3LnBuZw?x-oss-process=image/format,png
[https_www.cnblogs.com_wwj1992_articles_12569164.html]: https://www.cnblogs.com/wwj1992/articles/12569164.html