【Spring Boot】Spring Boot 配置文件详解（application.yml、application-dev.yml、application-test.yml ）

一、application.yml 基础配置

是 Spring Boot 中用于配置应用程序属性的主要配置文件之一。这个文件通常用于配置应用程序的一般性属性，包括数据库连接、日志级别、端口号等。下面是一些常见的在 application.yml 中配置的示例：

# 服务器端口
server:
  port: 8080

# 数据库连接配置
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydatabase
    username: root
    password: password
    driver-class-name: com.mysql.cj.jdbc.Driver

# 日志级别
logging:
  level:
    root: INFO
    com.example.mypackage: DEBUG

# 应用程序自定义属性
myapp:
  name: My Spring Boot App
  version: 1.0

上述示例展示了一些常用的配置项，但根据应用程序的需求，你可以在 application.yml 中配置各种属性。Spring Boot 非常灵活，可以根据属性的前缀识别属性，并将其绑定到对应的 Java 对象上，以方便在代码中使用。

需要注意的是，application.yml 文件采用 YAML（YAML Ain’t Markup Language）语法，它使用缩进和冒号来表示层次关系。因此，正确的缩进对于保持文件的结构是很重要的。

二、配置文件在项目中起到的具体作用

在 Spring Boot 中，可以通过属性文件（比如 application.yml 或 application.properties）来配置应用程序的属性。这些属性可以直接映射到 Java 对象中，从而在代码中方便地使用。

1、@ConfigurationProperties 注解

• 提供了一种方便的方式，可以将配置文件中的属性映射到 Java
  对象的字段上。这样做的一个常见的方式是使用属性的前缀来进行匹配。以下是一个简单的示例：

  # application.yml myapp:   database:
      url: jdbc:mysql://localhost:3306/mydatabase
      username: root
      password: password 
  

  import org.springframework.boot.context.properties.ConfigurationProperties;
  import org.springframework.stereotype.Component;
  
  @Component 
  @ConfigurationProperties(prefix = "myapp.database") public
  class DatabaseProperties {
      private String url;
      private String username;
      private String password;
  
      // Getters and setters
  
      // 可以在这里添加其他的业务逻辑 
  } 
  

  在这个例子中，DatabaseProperties 类的属性（url、username、password）会与
  application.yml 文件中 myapp.database 下的属性相匹配。Spring Boot 会自动将这些属性值注入到
  DatabaseProperties 实例中。

  然后，你可以在其他组件中注入 DatabaseProperties，并直接使用其中的属性：

  import org.springframework.beans.factory.annotation.Autowired;
  import org.springframework.stereotype.Service;
  
  @Service public class DatabaseService {
      private final DatabaseProperties databaseProperties;
  
      @Autowired
      public DatabaseService(DatabaseProperties databaseProperties) {
          this.databaseProperties = databaseProperties;
      }
  
      public void connectToDatabase() {
          String url = databaseProperties.getUrl();
          String username = databaseProperties.getUsername();
          String password = databaseProperties.getPassword();
  
          // 连接到数据库的逻辑...
      } 
  } 
  

  通过这种方式，你可以将配置文件中的属性映射到 Java
  对象上，并在代码中方便地使用这些属性。这种配置方式可以帮助你集中管理应用程序的配置，并提高代码的可维护性。

2、@Value 注解

• 使用 @Value 注解可以直接将配置文件中的属性值注入到 Spring Bean 中的字段或方法参数上。

  @Value("${property.name}") private String
     propertyName;
  

3、Environment 对象

• 通过 Environment 对象获取配置属性。

  @Autowired private Environment env;
     
  public void someMethod() {
     	String propertyValue = env.getProperty("property.name"); 
  }
  

4、 @PropertySource 注解引入外部属性文件

• 使用 @PropertySource 注解可以在配置类中引入外部的属性文件。

  public class MyConfiguration {
      @Value("${custom.property}")
      private String customProperty;
  } 
  

5、@ConfigurationPropertiesScan 注解（Spring Boot 2.2+）

• 这个注解允许在指定的包及其子包中扫描 @ConfigurationProperties 注解，无需显式声明
  @ConfigurationProperties 的 Bean。

  @ConfigurationPropertiesScan("com.example.config") 
  

这些方式都允许在应用程序中方便地访问配置文件中的属性值，开发者可以根据具体情况选择最适合的方式。

三、Spring Boot 的其他配置文件

在 Spring Boot 中，除了常见的 application.yml 或 application.properties 外，你还可以使用其他自定义的配置文件。Spring Boot 提供了以下几种常见的配置文件：

1、application.properties/application.yml

• 默认的主配置文件，Spring Boot 应用会自动加载该文件。存放应用程序的主要配置。

2、application-{profile}.properties/application-{profile}.yml：

• 可以根据不同的环境配置不同的属性文件，{profile} 表示环境名称。
  例如，application-dev.properties 用于开发环境，application-prod.properties
  用于生产环境。

3、bootstrap.properties/bootstrap.yml：

• 用于 Spring Cloud 应用，是 Spring Cloud Config 服务的默认配置文件。
  存放一些启动时需要优先加载的配置，比如连接到 Config Server 的配置。

4、application-{profile}.properties/application-{profile}.yml：

• 可以根据不同的环境配置不同的属性文件，{profile} 表示环境名称。 例如，application-dev.properties
  用于开发环境，application-prod.properties 用于生产环境。

5、application-{label}.properties/application-{label}.yml：

• 用于 Git 和配置服务器的外部化配置，{label} 表示 Git 的标签。
  例如，application-v1.properties 用于版本 1。

这些文件命名规范允许你根据不同的环境、配置标签或者配置文件类型组织和管理你的配置信息。Spring Boot 会根据上述规则自动加载相应的配置文件。

四、多配置文件使用哪个

Spring Boot 在启动时会加载默认的主配置文件，即 application.yml 或 application.properties。如果有不同环境的配置文件，如 application-test.yml 或 application-dev.yml，Spring Boot 会根据当前激活的环境来选择加载对应的配置文件。

1、设置 spring.profiles.active 指定激活环境

你可以通过在 application.yml 或 application.properties 中设置 spring.profiles.active 属性来指定激活的环境。例如：

spring:
  profiles:
    active: dev

上述配置表示激活 dev 环境，因此 Spring Boot 会加载 application-dev.yml 文件中的配置。

如果没有设置 spring.profiles.active 属性，Spring Boot 将默认使用主配置文件的配置。

2、命令行参数指定环境

除了通过属性文件来设置激活的环境外，你还可以通过命令行参数、系统属性、环境变量等方式来指定激活的环境。例如，通过命令行参数启动时指定环境：

java -jar your-application.jar --spring.profiles.active=dev

这样就会加载 application-dev.yml 的配置。

五、Springboot中配置文件的加载顺序

application.yml、application.properties和bootStrap.yml加载顺序

以jar包发布springboot项目时
默认会先使用jar包跟目录下的application.properties来作为项目配置文件。

如果在不同的目录中存在多个配置文件，它的读取顺序是：

1、config/application.properties（项目根目录中config目录下）
2、config/application.yml
3、application.properties（项目根目录下）
4、application.yml
5、resources/config/application.properties（项目resources目录中config目录下）
6、resources/config/application.yml
7、resources/application.properties（项目的resources目录下）
8、resources/application.yml