理解 Spring Boot 中 YML 文件的执行顺序
在现代开发中，Spring Boot 以其优雅的配置方式和良好的扩展性而受到广泛欢迎。YAML（YAML Ain't Markup Language）是一种用户友好的数据序列化格式，能够让我们用更少的代码进行配置。但是，你可能会好奇，在一个 Spring Boot 应用中，如果存在多个 YML 配置文件，它们的执行顺序是怎样的？本文将带你详细了解这一过程。
流程概述
Spring Boot 加载 YML 文件的顺序主要有以下几个步骤。我们来总结一下这些步骤，并用一个表格展示出来：
| 步骤 | 说明 |
|---|---|
| 1 | Spring Boot 启动时查找并加载配置文件（如 application.yml 和 application-{profile}.yml）。 |
| 2 | 应用主配置文件（application.yml 或 application.properties）被加载。 |
| 3 | 根据激活的 Profiles 加载特定的配置文件（如 application-dev.yml）。 |
| 4 | 加载系统属性以及环境变量构成的 YML 配置。 |
| 5 | 将所有配置合并，并应用最终配置。 |
详细步骤解析
下面我们逐一讲解这些步骤，并提供相应的代码示例和注释。
1. 加载应用主配置文件
Spring Boot 会默认查找 application.yml 或 application.properties 文件。确保你的项目中有这样一个配置文件：
# application.yml: 应用的主要配置文件
server:
port: 8080
spring:
application:
name: demo-application
这里我们配置了服务器端口为 8080，并给应用取了个名字 demo-application。
2. 加载特定的 Profiles
如果你喜欢使用不同的环境配置，可以使用 Profile。可以在 YML 文件中指定一个或多个 Profile，例子展示了如何在简单的 YML 文件中配置 dev 和 prod 环境。
# application-dev.yml: 开发环境的配置文件
spring:
datasource:
url: jdbc:mysql://localhost:3306/dev_db
username: dev_user
password: dev_password
# application-prod.yml: 生产环境的配置文件
spring:
datasource:
url: jdbc:mysql://localhost:3306/prod_db
username: prod_user
password: prod_password
为了使application-dev.yml生效，你需要在主配置文件中指定活动 Profile。
# application.yml
spring:
profiles:
active: dev # 指定活动 Profile
3. 加载系统属性和环境变量
在程序中，你仍然可以通过系统属性和环境变量进行配置。如果你想使用这些配置，可以像下面这样在代码中访问它们：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
@Component
public class DatabaseConfig {
@Value("${spring.datasource.url}") // 读取配置中的数据库 URL
private String databaseUrl;
@Value("${spring.datasource.username}") // 读取配置中的数据库用户名
private String databaseUsername;
@Value("${spring.datasource.password}") // 读取配置中的数据库密码
private String databasePassword;
// getters
}
4. 合并合理的配置
当 Spring Boot 启动时，它会合并所有的配置，包括主配置文件和通过 Profiles 指定的特定配置文件。后加载的配置会覆盖先前加载的配置。
序列图
以下序列图展示了 Spring Boot 在启动期间加载 YML 文件的执行顺序：
sequenceDiagram
participant A as User
participant B as Spring Boot
participant C as application.yml
participant D as application-{profile}.yml
participant E as Environment Variables
A->>B: Start Application
B->>C: Load application.yml
B->>D: Load application-{profile}.yml
B->>E: Load Environment Variables
B->>B: Merge Configurations
B-->>A: Application Running
流程图
我们可以用流程图来更好地说明这个加载 YML 文件的流程：
flowchart TD
A[开始 Spring Boot] --> B[加载 application.yml]
B --> C{是否有激活的 Profile?}
C -->|是| D[加载 application-{profile}.yml]
C -->|否| E[跳过]
D --> F[加载环境变量]
E --> F[加载环境变量]
F --> G[合并所有配置]
G --> H[应用启动]
结尾总结
通过上述步骤，我们了解到 Spring Boot 在启动时如何处理配置文件，包括应用主配置文件的加载、Profile 的处理，以及最终配置的合并。使用 YAML 文件配置你的应用时，确保清晰地构建结构、合理命名，并注意覆盖顺序，这将帮助你避免潜在的问题。此外，随着对 Spring Boot 更深入的理解，你可以更好地利用这些配置来提升你的开发效率。
希望这些内容能够帮助你顺利掌握 Spring Boot 中 YML 文件的执行顺序，更好地运用到你的项目开发中！如有任何疑问，不妨在代码实践中多加探讨和研究。
