✨Spring Boot 配置管理：如何让你的应用配置既灵活又高效？
🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！
环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8
前言：你还在为配置文件头痛吗？🧠
在软件开发中，配置文件无处不在。无论是数据库连接、缓存设置、还是服务端口号，这些配置几乎渗透到应用的每个角落。在传统的 Java 开发中，配置文件常常被硬编码在代码中，修改时需要重新编译和部署，十分麻烦。但幸运的是，Spring Boot 的出现彻底改变了这一点，它提供了灵活且高效的配置管理机制，让我们可以将所有配置集中管理，甚至在运行时动态更改配置。
今天，我们将深入探讨 Spring Boot 中的 配置文件管理。我们将涉及 application.properties 和 application.yml 文件的使用、如何将配置文件注入到代码中、外部化配置的实现，以及如何支持多环境配置。通过这些内容，大家将学会如何在实际开发中灵活使用 Spring Boot 的配置管理功能。
📚 目录
🌍 配置文件的管理：application.properties vs application.yml
💡 配置文件的注入与使用：让配置成为你的得力助手
🌐 外部化配置：支持配置文件、环境变量、命令行参数
🧑💻 多环境配置支持：如何根据不同环境（dev、prod、test）加载配置？
🛠 实际演练：如何快速配置 Spring Boot 应用
🌍 配置文件的管理：application.properties vs application.yml 📝
1. application.properties 文件：简单明了但有限制
application.properties 文件是最基础的配置文件格式，采用键值对方式，每个配置项占据一行。对于大多数简单的应用，application.properties 已经足够满足需求。
# 数据库配置
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=root
# 端口配置
server.port=8080
优点：
简单易懂：每一行都表示一个配置项，直接以 key=value 形式书写，易于理解和编辑。
标准化：Java 和 Spring 项目中常用这种方式进行配置。
缺点：
复杂配置难以表达：如果配置项需要多层嵌套（例如数据库相关的多项配置），使用 properties 格式时会显得比较繁琐。
没有层级结构：无法像 yml 那样方便地处理复杂的层级数据结构。
2. application.yml 文件：优雅的层级结构支持
application.yml 是 YAML 格式的配置文件，支持数据的层级结构，使得复杂的配置更加直观和简洁。尤其是在处理多层嵌套数据时，yml 格式的优势更加明显。
# 数据库配置
spring:
datasource:
url: jdbc:mysql://localhost:3306/mydb
username: root
password: root
# 端口配置
server:
port: 8080
优点：
结构清晰：YAML 格式自然支持层级结构，嵌套配置项更易读。
更适合复杂配置：例如，配置多个数据库连接或复杂的 JSON 数据结构时，YAML 格式更优雅。
缺点：
语法较为严格：YAML 对空格和缩进有严格要求，稍有不慎就可能导致配置错误。
哪个更好？
实际上，application.properties 和 application.yml 都有其优势和适用场景。对于简单配置，properties 格式较为直观。而对于复杂配置，尤其是需要嵌套或数组的情况，yml 格式显得更加清晰。
小结：
选择合适的格式取决于配置的复杂度和个人偏好。如果你的应用配置简单，使用 properties 即可；如果配置复杂，yml 格式会更适合。
💡 配置文件的注入与使用：让配置成为你的得力助手 ⚙️
在 Spring Boot 中，配置文件中的属性可以非常方便地注入到代码中，供业务逻辑使用。我们可以通过多种方式注入配置，最常用的是使用 @Value 注解和 @ConfigurationProperties 注解。
1. 使用 @Value 注解
@Value 注解非常适合注入单一的配置项。它可以将配置文件中的一个值直接注入到类的字段、方法参数或构造函数中。
代码示例：
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
@Component
public class MyService {
// 通过 @Value 注解将配置文件中的属性值注入到变量中
@Value("${spring.datasource.url}")
private String datasourceUrl;
public void printDatasourceUrl() {
System.out.println("Datasource URL: " + datasourceUrl);
}
}
解释：
@Value("${spring.datasource.url}")：从配置文件（如 application.properties 或 application.yml）中读取 spring.datasource.url 的值，并注入到 datasourceUrl 字段中。
2. 使用 @ConfigurationProperties 注解
@ConfigurationProperties 更适合注入一组相关的配置项。它可以将配置文件中的多个属性注入到一个对象中，尤其适用于复杂的配置结构。
代码示例：
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;
@Component
@ConfigurationProperties(prefix = "spring.datasource")
public class DatasourceConfig {
private String url;
private String username;
private String password;
// Getter 和 Setter 方法
public String getUrl() {
return url;
}
public void setUrl(String url) {
this.url = url;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public void printConfig() {
System.out.println("Datasource URL: " + url);
System.out.println("Username: " + username);
System.out.println("Password: " + password);
}
}
解释：
@ConfigurationProperties(prefix = "spring.datasource")：Spring Boot 会根据 spring.datasource 前缀自动将配置文件中的属性（如 url、username、password）注入到 DatasourceConfig 类中。
🌐 外部化配置：支持配置文件、环境变量、命令行参数 🌍
Spring Boot 提供了非常灵活的外部化配置机制，支持从多个来源读取配置，优先级由高到低依次为 命令行参数 > 环境变量 > 配置文件。这种方式大大提高了配置的灵活性和可维护性。
1. 配置文件：application.properties 和 application.yml
Spring Boot 会默认加载应用程序中的 application.properties 或 application.yml 配置文件。如果有多个配置文件，Spring Boot 会按照一定的优先级加载。
2. 环境变量
Spring Boot 会自动识别系统的环境变量。如果你的应用运行在 Docker、Kubernetes 等容器环境中，通常使用环境变量来传递配置项。
例如，在 Linux 或 macOS 上，你可以通过命令行设置环境变量：
export SPRING_DATASOURCE_URL=jdbc:mysql://localhost:3306/external_db
这样，Spring Boot 就会优先使用环境变量中的配置，而不是 application.properties 中的默认值。
3. 命令行参数
Spring Boot 还允许你通过命令行参数来传递配置。命令行参数优先级最高，可以直接在启动时覆盖配置文件中的值。
java -jar myapp.jar --spring.datasource.url=jdbc:mysql://localhost:3306/cli_db
配置的优先级顺序：
命令行参数（最高优先级）
环境变量
配置文件（application.properties 或 application.yml）
🧑💻 多环境配置支持：如何根据不同环境（dev、prod、test）加载配置？🌈
在实际开发中，应用往往需要根据不同的环境（如开发、生产、测试环境）来使用不同的配置。Spring Boot 提供了非常方便的多环境配置支持。
1. 使用 application-{profile}.properties 或 application-{profile}.yml
通过为不同的环境创建不同的配置文件，Spring Boot 可以根据 spring.profiles.active 属性加载相应的配置。
# application.properties
spring.profiles.active=dev
文件结构如下：
src/
└── main/
└── resources/
├── application.properties # 默认配置
├── application-dev.properties # 开发环境配置
├── application-prod.properties # 生产环境配置
└── application-test.properties # 测试环境配置
2. 激活特定环境配置
通过在 application.properties 或通过命令行设置 spring.profiles.active，你可以指定激活的环境。
# application.properties
spring.profiles.active=prod
或者通过命令行参数指定：
java -jar myapp.jar --spring.profiles.active=prod
3. 在配置文件中使用环境特定配置
不同的环境配置文件可以定义不同的配置项。例如，在 application-dev.properties 中为开发环境设置配置：
server.port=8081
而在 application-prod.properties 中则为生产环境设置配置：
server.port=80
Spring Boot 会根据激活的环境自动加载对应的配置。
🎉 总结：让配置管理更简单、更高效！
通过这篇文章，我们深入探讨了 Spring Boot 配置管理 的核心内容。无论是简单的属性注入，还是复杂的多环境配置，Spring Boot 都为我们提供了强大的支持。通过合理配置 application.properties 和 application.yml，并结合外部化配置和环境变量的支持，我们能够轻松管理和维护应用的配置，做到灵活切换不同环境和部署场景。
在实际开发中，选择适合的配置文件格式和注入方式，能大大提高开发效率和代码的可维护性。如果你还对 Spring Boot 配置管理有疑问，随时欢迎来聊！
🧧福利赠与你🧧
无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学SpringBoot」，bug菌郑重承诺，凡是学习此专栏的同学，均能获取到所需的知识和技能，全网最快速入门SpringBoot，就像滚雪球一样，越滚越大， 无边无际，指数级提升。
最后，如果这篇文章对你有所帮助，帮忙给作者来个一键三连，关注、点赞、收藏，您的支持就是我坚持写作最大的动力。
同时欢迎大家关注公众号:「猿圈奇妙屋」 ，以便学习更多同类型的技术文章，免费白嫖最新BAT互联网公司面试题、4000G pdf电子书籍、简历模板、技术文章Markdown文档等海量资料。
✨️ Who am I?
我是bug菌，CSDN | 掘金 | InfoQ | 51CTO | 华为云 | 阿里云 | 腾讯云 等社区博客专家，C站博客之星Top30，华为云多年度十佳博主/价值贡献奖，掘金多年度人气作者Top40，掘金等各大社区平台签约作者，51CTO年度博主Top12，掘金/InfoQ/51CTO等社区优质创作者；全网粉丝合计 30w+；更多精彩福利点击这里；硬核微信公众号「猿圈奇妙屋」，欢迎你的加入！免费白嫖最新BAT互联网公司面试真题、4000G PDF电子书籍、简历模板等海量资料，你想要的我都有，关键是你不来拿。
-End-