SpringBoot配置加载顺序

简介: SpringBoot配置加载顺序

目录

前言

一、Spring Boot 配置优先级

二、命令行参数

三、示例分析

前言

Spring Boot 不仅可以通过配置文件进行配置,还可以通过环境变量、命令行参数等多种形式进行配置。这些配置都可以让开发人员在不修改任何代码的前提下,直接将一套 Spring Boot 应用程序在不同的环境中运行。

一、Spring Boot 配置优先级

以下是常用的 Spring Boot 配置形式及其加载顺序(优先级由高到低):

1.命令行参数

2.来自 java:comp/env 的 JNDI 属性

3.Java 系统属性(System.getProperties())

4.操作系统环境变量

5.RandomValuePropertySource 配置的 random.* 属性值

6.配置文件(YAML文件、Properties 文件)

7.@Configuration 注解类上的 @PropertySource 指定的配置文件

8.通过SpringApplication.setDefaultProperties 指定的默认属性

以上所有形式的配置都会被加载,当存在相同配置内容时,高优先级的配置会覆盖低优先级的配置;存在不同的配置内容时,高优先级和低优先级的配置内容取并集,共同生效,形成互补配置。


二、命令行参数

Spring Boot 中的所有配置,都可以通过命令行参数进行指定,其配置形式如下。

java -jar {Jar文件名} --{参数1}={参数值1} --{参数2}={参数值2}

示例 1

  1. 在 springbootdemo 项目启动时,使用以下命令。
java -jar springbootdemo-0.0.1-SNAPSHOT.jar --server.port=8081 --server.servlet.context-path=/bcb

命令行参数说明如下:

–server.port:指定服务器端口号;

–server.servlet.context-path:指定上下文路径(项目的访问路径)。

执行结果如下图。

配置文件

Spring Boot 启动时,会自动加载 JAR 包内部及 JAR 包所在目录指定位置的配置文件(Properties 文件、YAML 文件),下图中展示了 Spring Boot 自动加载的配置文件的位置及其加载顺序,同一位置下,Properties 文件优先级高于 YAML 文件。

说明如下:


/myBoot:表示 JAR 包所在目录,目录名称自定义;

/childDir:表示 JAR 包所在目录下 config目录的子目录,目录名自定义;

JAR:表示 Spring Boot 项目打包生成的 JAR;

其余带有“/”标识的目录的目录名称均不能修改。

红色数字:表示该配置文件的优先级,数字越小优先级越高。

这些配置文件的优先级顺序,遵循以下规则:


先加载 JAR 包外的配置文件,再加载 JAR 包内的配置文件;

先加载 config 目录内的配置文件,再加载 config 目录外的配置文件;

先加载 config 子目录下的配置文件,再加载 config 目录下的配置文件;

先加载 appliction-{profile}.properties/yml,再加载application.properties/yml;

先加载 .properties 文件,再加载 .yml 文件。

示例 2

1.创建一个名为 mybootdemo 的 Spring Boot 项目,并在src/main/resoources下创建以下4个配置文件。

application.yml:默认配置

application-dev.yml:开发环境配置

application-test.yml:测试环境配置

application-prod.yml:生产环境配置


1)在 applcation.yml 文件中,指定默认服务端口号(port)为 “8080”,上下文路径(context-path)为“/mybootdemo”,并激活开发环境(dev)的 profile。

server:
  port: 8080 #端口号
  servlet:
    context-path: /mybootdemo #上下文路径或项目访问路径
spring:
  profiles:
    active: dev #激活开发环境配置

2)在 application-dev.yml 中,指定开发环境端口号为 “8081”,上下文路径为“/in-dev”,配置如下。

server:
  port: 8081 #开发环境端口号 8081
  servlet:
    context-path: /in-dev #开发环境上下文路径为 in-dev
spring:
  config:
    activate:
      on-profile: dev #开发环境

3)在 application-test.yml 中,指定测试环境端口号为 “8082”,上下文路径为“/in-test”,配置如下。

#测试环境配置
server:
  port: 8082 #测试环境端口 8082
  servlet:
    context-path: /in-test #测试环境上下文路径 /in-test
spring:
  config:
    activate:
      on-profile: test

4)在 application-prod.yml 中,指定生产环境端口号为 “8083”,上下文路径为“/in-prod”,配置如下。

#生产环境配置
server:
  port: 8083 #端口号
  servlet:
    context-path: /in-prod #上下文路径
spring:
  config:
    activate:
      on-profile: prod
  1. 2.执行以下 mvn 命令,将 mybootdemo 打包成 JAR,并将该 JAR 包移动到本次磁盘的某个目录下(例如 mySpringBoot 目录)。
mvn clean package
  1. 3.在 JAR 包所在目录下创建 application.yml ,并设置上下文路径为“/out-default”,并激活生产环境(prod)Profile。
#JAR 包外默认配置
server:
  servlet:
    context-path: /out-default
#切换配置
spring:
  profiles:
    active: prod #激活开发环境配置

打开命令行窗口,跳转到 mySpringBoot 目录下,执行以下命令启动 Spring Boot。

java -jar mybootdemo-0.0.1-SNAPSHOT.jar

启动结果如下图。


三、示例分析

1.Spring Boot 在启动时会加载全部的 5 个配置文件,其中位于 JAR 包外的 application.yml 优先级最高;

2.在 JAR 包外的 application.yml 中,配置激活了生产环境(prod)Profile,即 JAR 包内部的 application-prod.yml 生效。此时,该项目中的配置文件优先级顺序为:JAR 包外 3. application.yml >

JAR 包内 application-prod.yml >JAR 包内其他配置文件; application-prod.yml

的配置内容会覆盖 JAR

包内所有其他配置文件的配置内容,即端口号(port)为“8083”,上下文路径(context-path)为“/in-prod”;

3.JAR 包内的 application-prod.yml 中的上下文路径会被 JAR 包外的 application.yml 覆盖为“/out-default”;

4.JAR 包内的 application-prod.yml 与 JAR 包外的 application.yml,形成互补配置,即,端口号为“8083”,上下文路径为“/out-default”。


相关文章
|
2天前
|
Java Spring
聊一下Spring Boot配置的加载顺序
聊一下Spring Boot配置的加载顺序
31 0
|
7月前
|
Java
09 SpringBoot外部配置加载顺序
09 SpringBoot外部配置加载顺序
48 0
|
9月前
|
XML Java 数据格式
如何正确控制springboot中bean的加载顺序总结
springboot遵从约定大于配置的原则,极大程度的解决了配置繁琐的问题。在此基础上,又提供了spi机制,用spring.factories可以完成一个小组件的自动装配功能。 在一般业务场景,可能你不大关心一个bean是如何被注册进spring容器的。只需要把需要注册进容器的bean声明为@Component即可,spring会自动扫描到这个Bean完成初始化并加载到spring上下文容器。
|
2天前
|
Java
SpringBoot内部配置加载顺序
SpringBoot内部配置加载顺序
36 0
|
2天前
|
前端开发 Java 微服务
SpringBoot中的配置文件加载顺序
SpringBoot中的配置文件加载顺序
47 0
|
9月前
|
Ubuntu Java Windows
Spring Boot入门(十) 之 外部配置加载顺序
Spring Boot入门(十) 之 外部配置加载顺序
|
9月前
|
XML JSON 前端开发
springboot 的配置文件加载顺序
springboot 的配置文件加载顺序
|
XML JSON 搜索推荐
SpringBoot的配置【配置文件、加载顺序、配置原理】(超详细)上
SpringBoot的配置【配置文件、加载顺序、配置原理】(超详细)
SpringBoot的配置【配置文件、加载顺序、配置原理】(超详细)上
|
Java Spring
SpringBoot的配置【配置文件、加载顺序、配置原理】(超详细)下
SpringBoot的配置【配置文件、加载顺序、配置原理】(超详细)
SpringBoot的配置【配置文件、加载顺序、配置原理】(超详细)下
|
Java Maven Spring
SpringBoot系列教程之Bean加载顺序之错误使用姿势辟谣
在网上查询 Bean 的加载顺序时,看到了大量的文章中使用@Order注解的方式来控制 bean 的加载顺序,不知道写这些的博文的同学自己有没有实际的验证过,本文希望通过指出这些错误的使用姿势,让观文的小伙伴可以知道@Order的具体的应用场景
276 0
SpringBoot系列教程之Bean加载顺序之错误使用姿势辟谣