Spring 全家桶之 Spring Boot 2.6.4（二）- Configuration（Part B）（下）

properties格式配置文件多profiles方式

新建两个properties格式的配置文件，application-test.properties和application-dev.properties，通过设置端口号来确定使用的配置文件，默认使用application.properties

server.port=8081
server.servlet.context-path=/dev
复制代码

server.port=8082
server.servlet.context-path=/test
复制代码

可以在application.properties中增加配置激活哪个配置文件

spring.profiles.active=dev
复制代码

启动应用

根据输出的端口号可以确定application-dev.properties配置文件被激活。

yml格式配置文件多文档块方式

YML配置文件中可以使用“---”来区分文档块，文档块就相当于一个单独的配置文件。使用文档块，可以将dev配置和test配置写在一个配置文件中

spring:
  profiles:
  # 激活dev配置
    active: dev
---
# dev配置详情
server:
  port: 8083
spring:
  profiles: dev
---
# test配置详情
server:
  port: 8084
spring:
  profiles: test
---
复制代码

将properties格式配置文件中的内容全部注释掉，启动应用

根据控制台输出的端口号可以确定，YML文档块中的DEV部分被激活

命令行参数方式

在执行启动命令时使用"--spring.profile.active=dev"选择激活的配置文件，命令行模式的优先级大于配置文件

启动应用

根据端口可以确定test配置被激活

也可以通过在终端中执行启动命令

java -jar spring-boot-configuration-0.0.1-SNAPSHOT.jar --spring.profiles.active=test
复制代码

虚拟机参数方式

修改启动配置，在VM options中添加激活配置

再次启动

控制台成功输出指定的配置文件中设置的端口号

命令行、虚拟机配置和配置文件的优先级

命令行的优先级大于虚拟机

spring:
  profiles:
    active: dev
复制代码

虚拟机优先级大于配置文件

spring:
  profiles:
    active: test
复制代码

命令行 > 虚拟机 > 配置文件

六、配置文件位置的优先级

Spring Boot启动会扫描以下位置中的配置文件作为Spring Boot的默认主配置文件，优先级从高到低

• file:/config/
• file:/
• classpath:/config
• classpath:/ 也可以通过spring.config.location来改变默认配置，配置文件位置优先级也可以参考 你有没有掉进去过这些Spring Boot中的“陷阱“（上）- 配置文件加载顺序的“陷阱”

配置互补

工程目录下新增config目录，在该目录下新增application.yml，配置端口号

server:
  port: 8085
复制代码

resources目录下的配置文件新增内容

server:
  servlet:
    context-path: /app
  port: 8080
复制代码

启动项目，将VM参数和Programes参数清空

相同的配置被覆盖，不同的配置互补

spring.config.location 改变默认配置文件的位置

其他目录新建一个配置文件

server:
  port: 8088
复制代码

打包项目

java -jar spring-boot-configuration-0.0.1-SNAPSHOT.jar --spring.config.location=/Users/jingnan/Practice/March/application.yml
复制代码

plus：spring.config.location不能实现配置互补，或直接取代所有配置文件

spring.config.additional-location可以在指定配置文件的情况下同时实现互补

java -jar spring-boot-configuration-0.0.1-SNAPSHOT.jar --spring.config.additional-location=/Users/jgnan/Practice/March/application.yml
复制代码

参考文档Spring Boot 官方文档 External Application Properties

七、配置文件的加载顺序

配置文件官方文档 Spring Boot支持多种外部配置方式，优先级从高到低分别为

1. 命令行参数
2. 虚拟机参数
3. 操作系统参数
4. JAR包外部的带spring.profile的application-{profile}.properties或yml格式的配置文件
5. JAR包内部的带spring.profile的application-{profile}.properties或yml格式的配置文件
6. JAR包外部的不带spring.profile的application-{profile}.properties或yml格式的配置文件
7. JAR包内部的不带spring.profile的application-{profile}.properties或yml格式的配置文件
8. @Configuration类上的@PropertySource指定的配置文件
9. SpringApplication.setDefaultProperties指定的默认属性

优先加载profile命令的配置文件，优先从外向内寻找

八、Spring Boot自动配置项

Spring Boot配置文件中所有的配置项可以参考官方文档 Common Application Properties

从源码中查看配置项

Spring Boot所包含的自动配置类都在org.springframework.boot.autoconfigure包下的META-INF/spring.factories中

进入DispatcherServletAutoConfiguration自动配置类的源码中，该类上标注了@AutoConfigureAfter注解

@AutoConfigureAfter(ServletWebServerFactoryAutoConfiguration.class)
复制代码

进入ServletWebServerFactoryAutoConfiguration类

@EnableConfigurationProperties(ServerProperties.class)
复制代码

该类标注了@EnableConfigurationProperties注解，指定的XxxProperties类就包含了配置项

DispatcherServletAutoConfiguration 和ServletWebServerFactoryAutoConfiguration使用的是相同的配置

相关注解的作用

• @Configuration：表示这是一个配置类，同以往的XML配置文件一样，可以往容器中注册组件或者Bean
• @EnableConfigurationProperties：启动指定类的ConfigurationProperties功能，将配置文件中对应的值和XxxProperties绑定起来
• @AutoConfigureAfter：在某个自动配置类配置后在执行自动配置
• @ConfigurationProperties：从配置文件中获取指定的值和Bean的属性进行板顶

所有的配置项都来自自动配置类中启用的XxxProperties类，也就说说一旦自动配置类生效，这个配置类就会给容器中注册各种组件，这些组件的属性都是从@EnableConfigurationProperties注解指定的XxxProperties类中获取的，这些类里面的每一个属性和配置文件是一一绑定的

总结

• XxxxAutoConfiguration是自动配置类，往容器中注册组件
• XxxProperties封装了配置文件中的相关属性
• @Conditional派生注解

如何查看启用和未启用的配置

官方配置文档中的第一项是debug，设置debug=true时控制台会输出哪些配置类启用

debug: true
复制代码

启动主程序

控制台会打印出当前应用程序中所有激活的和未激活的配置