✨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 的配置管理功能。

📚 目录

1. 🌍 配置文件的管理：application.properties vs application.yml
2. 💡 配置文件的注入与使用：让配置成为你的得力助手
3. 🌐 外部化配置：支持配置文件、环境变量、命令行参数
4. 🧑‍💻 多环境配置支持：如何根据不同环境（dev、prod、test）加载配置？
5. 🛠 实际演练：如何快速配置 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

配置的优先级顺序：

1. 命令行参数（最高优先级）
2. 环境变量
3. 配置文件（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-