Spring Profiles完全解析：从基础用法到高级特性

Spring Profiles完全解析：从基础用法到高级特性

引用

CSDN

1.

https://m.blog.csdn.net/yangshangwei/article/details/144882451

Spring Profiles是Spring Boot中一个非常重要的配置管理机制，它允许开发者根据不同的环境（如开发、测试、生产等）来隔离和加载特定的配置。本文将从基本用法到高级特性，全面解析Spring Profiles的使用方法，帮助开发者更好地管理和维护不同环境下的应用程序配置。

Spring Profiles 详解

Spring Profiles 提供了一种将应用程序配置的部分内容隔离并仅在特定环境中可用的方式。通过使用
@Profile注解，可以限制
@Component、
@Configuration或
@ConfigurationProperties类在特定环境下加载。接下来我们将详细介绍 Spring Profiles 的使用方法，包括如何激活 Profiles、添加 Active Profiles、Profile Groups 以及如何在代码中设置 Profiles。

1. 基本用法

任何
@Component、
@Configuration或
@ConfigurationProperties类都可以通过
@Profile注解来限制其加载时机。例如，以下配置类仅在
productionProfile 激活时加载：

import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Profile;

@Configuration(proxyBeanMethods = false)
@Profile("production")
public class ProductionConfiguration {
    // ...
}

如果
@ConfigurationProperties类是通过
@EnableConfigurationProperties注册的，而不是通过自动扫描注册的，则需要在带有
@EnableConfigurationProperties注解的
@Configuration类上指定
@Profile注解。如果
@ConfigurationProperties类是扫描注册的，则可以直接在
@ConfigurationProperties类上指定
@Profile注解。

2. 激活 Profiles

可以通过
spring.profiles.active环境属性来指定哪些 Profiles 是激活的。可以在
application.properties中指定该属性，例如：

spring.profiles.active=dev,hsqldb

也可以在命令行中使用
--spring.profiles.active参数来指定：

java -jar myapp.jar --spring.profiles.active=dev,hsqldb

如果没有激活任何 Profile，则会启用默认的 Profile。默认 Profile 的名称是
default，可以通过
spring.profiles.default属性进行调整：

spring.profiles.default=none

需要注意的是，
spring.profiles.active和
spring.profiles.default只能在非 Profile 特定的文档中使用。这意味着它们不能包含在 Profile 特定的文件或由
spring.config.activate.on-profile激活的文档中。

例如，以下配置是无效的：

spring.profiles.active=prod
#---
spring.config.activate.on-profile=prod
spring.profiles.active=metrics

3. 添加 Active Profiles

spring.profiles.active属性遵循与其他属性相同的优先级规则：最高优先级的
PropertySource会生效。这意味着可以在
application.properties中指定激活的 Profiles，然后通过命令行参数替换它们。

有时，我们希望添加激活的 Profiles 而不是替换它们。可以使用
spring.profiles.include属性在
spring.profiles.active激活的 Profiles 基础上添加额外的 Profiles。

SpringApplication入口点还提供了一个 Java API 来设置额外的 Profiles，即
setAdditionalProfiles()方法。

例如，当运行以下配置的应用程序时，即使使用
--spring.profiles.active参数，
common和
localProfiles 也会被激活：

spring.profiles.include[0]=common
spring.profiles.include[1]=local

与
spring.profiles.active类似，
spring.profiles.include只能在非 Profile 特定的文档中使用。

4. Profile Groups

有时，应用程序中定义和使用的 Profiles 过于细粒度，使用起来会变得繁琐。例如，可能有两个 Profiles：
proddb和
prodmq，分别用于启用数据库和消息功能。

为了解决这个问题，Spring Boot 允许你定义 Profile Groups。Profile Group 允许你为相关的 Profiles 定义一个逻辑名称。

例如，我们可以创建一个
production组，包含
proddb和
prodmqProfiles：

spring.profiles.group.production[0]=proddb
spring.profiles.group.production[1]=prodmq

现在，可以通过
--spring.proields.active=production来启动应用程序，从而一次性激活
production、
proddb和
prodmqProfiles。

与
spring.profiles.active和
spring.profiles.include类似，
spring.profiles.group只能在非 Profile 特定的文档中使用。

5. 在代码中设置 Profiles

你可以在应用程序运行之前通过调用
SpringApplication.setAdditionalProfiles(...)来以编程方式设置激活的 Profiles。还可以使用 Spring 的
ConfigurableEnvironment接口来激活 Profiles。

例如：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(MyApplication.class);
        app.setAdditionalProfiles("dev", "hsqldb");
        app.run(args);
    }
}

6. Profile 特定的配置文件

Spring Boot 支持 Profile 特定的配置文件，例如
application-dev.properties或
application-prod.yaml。这些文件会根据激活的 Profiles 自动加载。例如，如果激活了
devProfile，则
application-dev.properties文件会被加载。

还可以在
@ConfigurationProperties类中引用 Profile 特定的配置文件。例如：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;

@Configuration
@ConfigurationProperties(prefix = "myapp")
public class MyAppProperties {
    private String name;
    private String description;
    // Getters and setters
}

然后在
application-dev.properties中指定属性：

myapp.name=MyApp (Dev)
myapp.description=This is the development environment.

总结

Spring Profiles 提供了一种灵活的方式来管理不同环境下的应用程序配置。通过
@Profile注解，可以轻松地控制配置类和组件的加载时机。通过
spring.profiles.active和
spring.profiles.include属性，可以灵活地激活和组合 Profiles。Profile Groups 则进一步简化了多个相关 Profiles 的管理。此外，Spring Boot 还支持 Profile 特定的配置文件，使得不同环境下的配置管理更加方便。