应用配置管理：轻松掌控配置文件和多环境设置！

🏆本文收录于「滚雪球学SpringBoot」专栏，手把手带你零基础入门Spring Boot，从入门到就业，助你早日登顶实现财富自由🚀；同时，欢迎大家关注&&收藏&&订阅！持续更新中，up！up！up！！

环境说明：Windows 10 + IntelliJ IDEA 2021.3.2 + Jdk 1.8

📖 前言：配置文件，是你应用的隐形英雄

在开发应用时，你会发现一个不太起眼的“英雄”——配置文件。当你开发一个小型应用时，配置文件或许不会引起你太多的注意，但随着项目的复杂化和多环境的需求，这些配置文件变得越来越重要。它们能够帮助你轻松管理不同的环境设置，支持快速切换环境配置，甚至让你减少了很多不必要的手动操作。🌱

今天，我们就来聊聊如何通过配置文件（比如 application.properties 或 application.yml）来管理配置，如何用 @Value 注解注入配置，以及如何高效地管理多个环境的配置。没有这些配置文件的灵活管理，开发和部署将变得异常麻烦。

🔍 目录

1. 📝 配置文件介绍（application.properties / application.yml）
2. 🔌 通过 @Value 注解注入配置
3. 🌍 配置文件的分环境管理
4. 🔧 实用示例与最佳实践

📝 配置文件介绍（application.properties / application.yml）

在 Spring Boot 应用中，配置文件是你与应用之间的沟通桥梁。它主要有两种常见的格式：application.properties 和 application.yml。

1. application.properties

这种格式的配置文件是简单的键值对，格式非常直观，例如：

# 配置数据库连接
spring.datasource.url=jdbc:mysql://localhost:3306/mydb
spring.datasource.username=root
spring.datasource.password=secret

这种格式使用 = 或 : 来分隔键和值，每一行代表一个配置项，适合简单明了的配置。

2. application.yml

YAML（YAML Ain’t Markup Language）是一种比 .properties 更为人性化的配置格式。它通过层级缩进来表示父子关系，结构更加清晰，适合复杂的配置管理。例如：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mydb
    username: root
    password: secret

YAML 格式具有更好的可读性，特别是在涉及多个配置项的情况下。它是 .properties 的一种更易于维护的替代品。

🔌 通过 @Value 注解注入配置

一旦你配置好了文件中的属性，接下来你就需要将它们注入到应用的 Java 类中，以便在代码中使用。Spring Boot 提供了 @Value 注解来轻松地注入这些配置。

示例：如何注入配置

假设我们在 application.properties 文件中有如下配置：

app.name=MySpringBootApp
app.version=1.0.0

现在我们需要将这些配置项注入到我们的类中，使用 @Value 注解非常简单：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Component
public class AppConfig {

    @Value("${app.name}")
    private String appName;

    @Value("${app.version}")
    private String appVersion;

    public void printAppInfo() {
        System.out.println("Application Name: " + appName);
        System.out.println("Application Version: " + appVersion);
    }
}

在这个示例中，@Value("${app.name}") 和 @Value("${app.version}") 将配置文件中的 app.name 和 app.version 的值注入到 appName 和 appVersion 变量中。这样，在代码中你就可以直接使用这些配置。

@Value 的高级用法

@Value 注解不仅支持注入单一值，还支持默认值、环境变量、甚至是集合类型的注入：

• 默认值：

@Value("${app.name:DefaultAppName}")
private String appName;  // 如果配置文件没有定义该属性，将使用默认值 DefaultAppName

• 注入列表：

@Value("#{'${app.urls}'.split(',')}")
private List<String> urls;  // 注入以逗号分隔的字符串列表

🌍 配置文件的分环境管理

当你在不同的环境（比如开发、测试和生产环境）中部署应用时，你需要根据不同的环境来调整配置文件中的内容。Spring Boot 提供了非常方便的环境切换功能，使得你能够根据当前的运行环境加载不同的配置。

1. 使用 application-{profile}.properties 或 application-{profile}.yml

Spring Boot 允许通过配置文件中的Profile来为不同的环境提供不同的配置。例如，你可以为开发环境和生产环境分别提供不同的配置文件：

• application-dev.properties
• application-prod.properties

你可以在主配置文件 application.properties 中指定当前使用的 profile：

spring.profiles.active=dev

或者，如果使用的是 application.yml：

spring:
  profiles:
    active: dev

在这个示例中，Spring Boot 会加载 application-dev.properties 配置文件中的内容。你可以根据需要为不同的环境配置不同的文件，从而实现环境之间的灵活切换。

2. 根据不同环境加载不同配置

例如，针对生产环境和开发环境，你可能会有如下不同的配置：

• 开发环境 (application-dev.properties)：

app.database.url=jdbc:mysql://localhost:3306/dev_db
app.database.username=dev_user
app.database.password=dev_password

• 生产环境 (application-prod.properties)：

app.database.url=jdbc:mysql://prod-db-server:3306/prod_db
app.database.username=prod_user
app.database.password=prod_password

通过这样的配置，应用会根据 spring.profiles.active 的值来加载相应的环境配置。

3. 命令行参数和外部配置文件

除了使用 application.properties 或 application.yml 来指定环境外，你还可以通过命令行参数或外部配置文件来指定环境：

java -jar myapp.jar --spring.profiles.active=prod

这种方式尤其适合在不同的部署环境中使用（如 Docker 部署），从而可以在启动时灵活地切换不同的环境配置。

🔧 实用示例与最佳实践

示例：多环境配置管理

# application.properties
spring.profiles.active=dev  # 默认开发环境

# application-dev.properties
app.name=MyAppDev
app.db.url=jdbc:mysql://localhost:3306/devdb

# application-prod.properties
app.name=MyAppProd
app.db.url=jdbc:mysql://prod-server:3306/proddb

在这个示例中，我们通过环境切换，能够在开发和生产环境中使用不同的数据库配置。当你切换到生产环境时，只需要修改 spring.profiles.active=prod，即可让应用自动加载生产环境的数据库配置。

最佳实践

1. 使用 @Value 注解时避免硬编码：建议使用 @Value 注解时，不要硬编码配置值，而是将常用的配置值提取成常量或配置类，以提高代码的可维护性。
2. 敏感信息存储的安全性：数据库密码、API 密钥等敏感信息，尽量不要直接写在配置文件中，考虑使用加密方式或外部配置管理工具来存储敏感信息。
3. 简化环境切换：通过 application-{profile}.properties 的方式进行环境隔离，并通过 spring.profiles.active 来动态切换环境，保持代码的灵活性。

🏁 结语：配置管理，简单又强大！

通过合理地使用 application.properties 或 application.yml 配置文件、@Value 注解注入配置，并有效管理不同环境的配置，你就能大大提高应用的灵活性和可维护性。配置文件管理虽然看起来简单，但它对开发过程中的环境切换、版本管理和部署流程都有着深远的影响。

所以，接下来你可以尽情地管理自己的配置文件了，不再为环境配置而头疼啦！🎉

🧧福利赠与你🧧

  无论你是计算机专业的学生，还是对编程有兴趣的小伙伴，都建议直接毫无顾忌的学习此专栏「滚雪球学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-