SpringBoot中配置文件：property、yml、yaml加载顺序和优先级

一、引言

在SpringBoot项目中，配置文件是项目的重要组成部分，决定了应用的行为和环境配置。常见的配置文件格式包括property、yml、yaml，它们在不同环境下有不同的加载顺序和优先级。理解和正确使用这些配置文件，可以帮助开发者更好地管理应用的配置，提升开发效率和应用的稳定性。

二、配置文件格式介绍

1. Property文件

Property文件是以.properties为后缀的配置文件，使用键值对的形式来配置参数。例如：

server.port=8080
spring.datasource.url=jdbc:mysql://localhost:3306/db

2. Yml文件

Yml文件是以.yml为后缀的配置文件，使用缩进的方式来表示层次结构。例如：

server:
  port: 8080
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/db

3. Yaml文件

Yaml文件是以.yaml为后缀的配置文件，语法和Yml文件类似，主要是文件后缀名的区别。

三、加载顺序和优先级

1. 默认配置文件

SpringBoot会按照以下顺序加载默认的配置文件：

1. application.properties
2. application.yml
3. application.yaml

2. 环境特定配置文件

环境特定的配置文件会覆盖默认配置文件中的相应配置。SpringBoot按照以下顺序加载环境特定的配置文件：

1. application-{profile}.properties
2. application-{profile}.yml
3. application-{profile}.yaml

其中，{profile}是当前激活的环境，如dev、test、prod等。

3. 外部配置文件

SpringBoot支持从外部加载配置文件，加载顺序如下：

1. 命令行参数：--server.port=8080
2. SPRING_APPLICATION_JSON中的配置：export SPRING_APPLICATION_JSON='{"server":{"port":8080}}'
3. jar包外部的配置文件：
   • file:./config/application.properties
   • file:./config/application.yml
   • file:./config/application.yaml
   • file:./application.properties
   • file:./application.yml
   • file:./application.yaml
4. jar包内部的配置文件：
   • classpath:/config/application.properties
   • classpath:/config/application.yml
   • classpath:/config/application.yaml
   • classpath:/application.properties
   • classpath:/application.yml
   • classpath:/application.yaml

4. 多个文件同时存在的优先级

当多个配置文件同时存在时，SpringBoot会按照以下优先级覆盖配置：

1. 命令行参数 >
2. SPRING_APPLICATION_JSON >
3. file:./config/application-{profile}.properties >
4. file:./config/application-{profile}.yml >
5. file:./config/application-{profile}.yaml >
6. file:./application-{profile}.properties >
7. file:./application-{profile}.yml >
8. file:./application-{profile}.yaml >
9. classpath:/config/application-{profile}.properties >
10. classpath:/config/application-{profile}.yml >
11. classpath:/config/application-{profile}.yaml >
12. classpath:/application-{profile}.properties >
13. classpath:/application-{profile}.yml >
14. classpath:/application-{profile}.yaml

四、最佳实践

1. 使用环境特定配置文件

在开发过程中，使用环境特定的配置文件可以根据不同的环境（开发、测试、生产）加载不同的配置。例如，在生产环境中，使用application-prod.yml来配置生产环境的参数。

2. 优先使用Yml或Yaml文件

Yml和Yaml文件具有更好的可读性和层次结构，推荐优先使用Yml或Yaml文件进行配置管理。

3. 命令行参数和环境变量优先

在CI/CD流程中，可以使用命令行参数或环境变量来覆盖配置文件中的配置，确保在不同环境中运行时具有灵活性和可配置性。

五、结论

通过理解SpringBoot中property、yml、yaml配置文件的加载顺序和优先级，开发者可以更好地管理项目的配置，提升开发效率和应用的稳定性。在实际开发中，合理利用不同格式的配置文件和加载顺序，可以帮助开发者实现灵活和高效的配置管理。

希望这篇文章能帮助您更好地理解SpringBoot配置文件的加载顺序和优先级，为您的开发工作提供有力支持。