摘要：在当今的软件开发领域，我们常常需要将同一套代码部署到不同的环境中，比如开发环境、测试环境以及生产环境等。不同环境下，配置信息，如数据库连接、服务器端口等，往往大不相同。想象一下，如果每次切换环境都要手动繁琐地修改大量配置，那将会耗费多少时间和精力，还极易出错。
在当今的软件开发领域，我们常常需要将同一套代码部署到不同的环境中，比如开发环境、测试环境以及生产环境等。不同环境下，配置信息，如数据库连接、服务器端口等，往往大不相同。想象一下，如果每次切换环境都要手动繁琐地修改大量配置，那将会耗费多少时间和精力，还极易出错。而 Spring Boot 3 强大的多环境配置功能，就如同一场及时雨，让这一难题迎刃而解，让配置管理变得高效又简单。接下来，就让我们一同深入探索 Spring Boot 3 中实现多环境配置文件加载的方法。
在 Spring Boot 3 项目里，对于 application.properties 文件，多环境配置实现起来非常直观。我们通过创建多个以 application-{profile}.properties 命名的文件，就能轻松定义不同环境的专属配置。这里的 {profile}，就代表着环境标识，常见的有 dev（开发环境）、test（测试环境）、prod（生产环境）等。
举个例子，我们有一个主配置文件 application.properties，它可以通过 spring.profiles.active 属性，清晰地指定当前激活的环境。假设我们在开发环境中，希望数据库连接地址是本地的测试数据库，端口为 3306，那我们就可以在 application-dev.properties 文件中这样配置：
spring.datasource.url=jdbc:mysql://localhost:3306/testdbspring.datasource.username=devuserspring.datasource.password=devpassword而在主配置文件 application.properties 中，指定激活开发环境：
spring.profiles.active=dev这样，当项目启动时，就会自动加载 application-dev.properties 里的配置信息，为开发工作提供便利。
（二）YAML 配置方式
YAML 格式因其简洁、易读的特性，在 Spring Boot 项目中也备受开发者喜爱。在 Spring Boot 3 里，使用 YAML 进行多环境配置有两种常见方式。
单文件多文档块配置
我们可以在一个 application.yml 文件中，利用多个文档块（以 — 分隔）来定义不同环境的配置。每个文档块里，通过 spring.profiles 属性来明确当前文档块对应的环境。
比如：
server:port: 8080spring:profiles:active: dev---spring:profiles: devserver:port: 8081# 开发环境下的其他特殊配置，如特定的日志级别等logging:level:root: debug---spring:profiles: testserver:port: 8082# 测试环境下的数据库连接等特殊配置spring:datasource:url: jdbc:mysql://testdbserver:3306/testdbusername: testuserpassword: testpassword---spring:profiles: prodserver:port: 8083# 生产环境下的数据库连接等特殊配置spring:datasource:url: jdbc:mysql://prodserver:3306/proddbusername: produserpassword: prodpassword在这个例子中，spring.profiles.active=dev 指定了默认激活开发环境，Spring Boot 会优先加载 spring.profiles: dev 对应的配置块。
多文件配置
YAML 配置的多文件方式，文件命名一般遵循 application-{profile}.yml 的格式，其中 {profile} 为环境标识。主配置文件 application.yml 通常可不定义具体环境配置，而是指定默认激活环境，或者包含一些公共配置。
比如，主配置文件 application.yml 可以这样写：
spring:profiles:active: dev开发环境配置文件（application-dev.yml）：
server:port: 8081spring:datasource:url: jdbc:mysql://localhost:3306/devdbusername: devuserpassword: devpassword# 开发环境下的其他特殊配置，如特定的缓存策略等cache:type: simple测试环境配置文件（application-test.yml）：
server:port: 8082spring:datasource:url: jdbc:mysql://testdbserver:3306/testdbusername: testuserpassword: testpassword# 测试环境下的其他特殊配置，如模拟服务地址等mock:service-url: http://mockserver:8080生产环境配置文件（application-prod.yml）：
server:port: 8083spring:datasource:url: jdbc:mysql://prodserver:3306/proddbusername: produserpassword: prodpassword# 生产环境下的其他特殊配置，如安全相关配置等security:enabled: true在 Spring Boot 3 中，激活特定环境配置的方式多种多样，开发者可以根据实际需求灵活选择。
（一）在配置文件中指定
正如前文所述，在 application.properties 或 application.yml 文件中，通过 spring.profiles.active 属性就能轻松指定激活的环境。这种方式简单直接，适合大多数常规场景。比如在 application.yml 中：
spring:profiles:active: test（二）通过命令行参数指定
在启动应用程序时，使用命令行参数–spring.profiles.active，能够方便快捷地指定激活的环境。这种方式特别适用于临时切换环境进行测试等情况。例如，在命令行中输入：
java -JAR your - application.jar --spring.profiles.active=prod这样，就会启动生产环境的配置。
（三）通过环境变量指定
设置环境变量 SPRING_PROFILES_ACTIVE，也可以指定激活的环境。在一些自动化部署场景中，这种方式尤为常用。比如在 Linux 系统中，可以通过以下命令设置环境变量并启动应用：
export SPRING_PROFILES_ACTIVE=devjava -jar your - application.jar（四）在 IDE 中指定
如果使用 IDE（如 IntelliJ IDEA 或 Eclipse）运行应用程序，在运行配置中就能轻松指定激活的环境。以 IntelliJ IDEA 为例，打开运行配置窗口，在 “VM options” 中输入：
-Dspring.profiles.active=dev就能指定以开发环境启动项目。
打包时的注意事项在打包 Spring Boot 应用程序时，确保配置文件被正确包含至关重要。一般情况下，使用 Maven 或 Gradle 等构建工具进行打包，配置文件会自动被纳入生成的 JAR 或 WAR 包中。
如果需要为不同环境打包不同的配置文件，Maven 的 profiles 功能或 Gradle 的构建变体（build variants）可以大显身手。以 Maven 为例，在 pom.xml 文件中，我们可以定义不同的 profiles，为每个 profile 指定要包含的配置文件。
首先，在主配置文件 application.yml 中，使用占位符来指定当前激活的环境。这里的 @profiles.active@就是一个占位符，它会在 Maven 打包时被替换为实际的环境标识。例如：
spring:profiles:active: @profiles.active@然后，在 pom.xml 文件中配置多个环境：
devtrue
dev
test
test
prod
prod
为了让 Maven 在打包时能够替换主配置文件中的占位符，还需在 pom.xml 中配置资源过滤：
src/main/resourcestrue配置好这些后，就可以使用 Maven 的打包命令生成不同环境的构建产物。比如，生成开发环境的构建产物，使用命令：
mvn clean package由于开发环境被设置为默认激活环境，上述命令会生成开发环境的构建产物。若要生成测试环境或生产环境的构建产物，可以使用 - P 参数指定要激活的环境，如：
（一）配置文件的管理
确保所有环境配置文件都放置在正确目录下，文件名严格符合 application-{profile}.yml 或 application-{profile}.properties 的格式。对于不同环境的配置，要清晰区分，避免混淆。同时，可以将一些公共配置提取到主配置文件或公共配置文件中，减少重复代码。
（二）占位符的使用
在使用占位符（如 @符号作为占位符定界符）时，要注意在 Spring Boot 和 Maven 等构建工具中的兼容性。如果使用 Maven，也可使用 ${} 作为占位符定界符，但由于 Spring Boot 可能覆盖 Maven 默认行为，建议统一使用 @符号，以确保一致性。
（三）资源文件的包含与排除
在 pom.xml 中配置资源过滤时，通过和标签，精确指定要包含或排除的资源文件，保证只有正确的资源文件被打包进最终构建产物，避免不必要的文件干扰。
（四）清理项目
每次打包前，强烈建议使用 mvn clean 命令清理项目，清除构建过程中产生的旧的或不必要的文件，确保构建的纯净性，避免潜在的问题。
（五）@Profile 注解的使用
Spring Boot 提供的 @Profile 注解，可在代码级别根据环境加载特定的 Bean。合理使用该注解，能进一步提升代码的可维护性和灵活性。比如，在开发环境中使用内存数据库 H2 进行快速开发和测试，在生产环境中切换到 MySQL 数据库，通过 @Profile 注解就能轻松实现。
@Configurationpublic class DatabaseConfig {@Bean@Profile("dev")public DataSource devDataSource {// 配置开发环境下的数据源，如H2数据库EmbeddedDatabaseBuilder builder = new EmbeddedDatabaseBuilder;return builder.setType(EmbeddedDatabaseType.H2).build;}@Bean@Profile("prod")public DataSource prodDataSource {// 配置生产环境下的数据源，如MySQL数据库DriverManagerDataSource dataSource = new DriverManagerDataSource;dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");dataSource.setUrl("jdbc:mysql://prodserver:3306/proddb");dataSource.setUsername("produser");dataSource.setPassword("prodpassword");return dataSource;}}Spring Boot 3 的多环境配置功能为开发者在不同环境下部署和管理应用提供了极大便利。通过合理运用配置文件、灵活选择环境激活方式、注意打包细节以及遵循最佳实践，我们能够高效地开发、测试和部署项目，提升开发效率和代码质量。希望本文能帮助各位开发者在 Spring Boot 3 项目中轻松实现多环境配置文件加载，让项目在不同环境中都能稳定、高效地运行。
来源：从程序员到架构师一点号