SpringBoot--Profile你用对了吗

狸如鲤伴

于 2025-07-23 06:33:59 发布

阅读量12

点赞数

文章标签： spring boot java spring 后端 mybatis

合集 - Spring Boot 企业级应用系列(8)

1.SpringBoot--简单入门07-08 2.SpringBoot--配置加载、分析器、监听器、初始化器等07-11 3.SpringBoot--如何给项目添加配置属性及读取属性07-11 4.SpringBoot--如何整体读取多个配置属性及其相关操作07-13

5. SpringBoot-- Profile你用对了吗 07-14

6.SpringBoot--学会配置日志07-16 7.SpringBoot--自动配置的替换和关闭07-18 8.SpringBoot--如何创建自己的自动配置07-21

所谓Profile，就是一组配置环境，各种程序组件的合集。

实际开发中，经常要在不同的环境间切换，比如，开发时应用的是开发场的部署环境；测试时，用的是测试场的部署环境；上线时，用的是产品场的部署环境。传统做法是手动更改配置信息，但实际项目中配置信息比较多，这样做起来很麻烦，还容易出错，而Profile就是来解决这个问题的。

每个Profile都包含一组配置文件和程序组件等，对应有一个部署环境。只要为每个环境提供对应的Profile，当需要切换不同的部署环境时，只要切换到对应的Profile即可。

配置和切换Profile

声明程序组件和配置文件的Profile有以下方式：

使用@Profile注解修饰@Component、@Configuration、@ConfigurationProperties等注解修饰的类，这限制了这些类仅对特定的Profile有效
通过配置文件名限制Profile。比如application-dev.properties（或application-dev.yml）文件仅对dev Profile有效。application-test.properties（或application-test.yml）文件仅对test Profile有效。
在配置文件中使用特定语法限制某些属性对特定的Profile有效。这种特殊的配置文件称为“多Profile配置文件”。

对于@ConfigurationProperties类的必要说明：

如果@ConfigurationProperties类是通过@EnableConfigurationProperties注解来启用的，则需要在@EnableConfigurationProperties注解所在的@Configuration类上使用@Profile注解。
如果@ConfigurationProperties类是通过@ConfigurationPropertiesScan注解（扫描方式）来启用的，则需要在@ConfigurationProperties类本身上使用@Profile注解。

代码示例：\resources\application-default.yml

spring:
  datasource:
    # 指定连接deft数据库
    url: jdbc:mysql://localhost:3306/deft?serverTimezone=UTC
    username: root
    password: 32147

代码示例：\resources\application-dev.yml

spring:
  datasource:
    # 指定连接dev数据库
    url: jdbc:mysql://localhost:3306/dev?serverTimezone=UTC
    username: root
    password: 32147

代码示例：\resources\application-test.yml

spring:
  datasource:
    # 指定连接test数据库
    url: jdbc:mysql://localhost:3306/test?serverTimezone=UTC
    username: root
    password: 32147

代码示例：\resources\application-prod.yml

spring:
  datasource:
    # 指定连接prod数据库
    url: jdbc:mysql://localhost:3306/prod?serverTimezone=UTC
    username: root
    password: 32147

控制器类：

@RestController
// 指定当前控制器的Profile为"default"
@Profile("default")
public class DefaultController
{
   private final DataSource dataSource;
   @Autowired
   public DefaultController(DataSource dataSource)
   {
      this.dataSource = dataSource;
   }
   @GetMapping
   public Map<String, String> hello() throws SQLException
   {
      return Map.of("class", "默认场的控制器","数据库",
            dataSource.getConnection().getCatalog());
   }
}

在运行应用时，可通过spring.profiles.active属性指定激活哪个Profile，主要使用如下方式来指定：

通过application.properties（或application.yml）指定
使用操作系统的SPRING_PROFILES_ACTIVE环境变量指定
使用系统属性指定
使用命令行参数指定

以上4种方式按加载顺序排列，先加载的属性具有低优先级，因此通过命令行参数指定会覆盖前面几种方式指定的属性。

如果程序没有指定spring.profiles.active属性，则会默认使用default profile。

如果程序中定义了通用的配置文件application.properties（或application.yml），SpringBoot也会加载它，但特定的profile配置文件优先级更高，它会覆盖通用配置文件中的同名属性。

添加活动Profile

除了可以改变激活的Profile，SpringBoot还允许添加额外的活动Profile，新增的活动Profile不会彻底替换原有的Profile，而是对原有的Profile进行追加：当追加的Profile的配置属性与原有的冲突时，追加的配置属性会覆盖原有的属性，否则依然使用原有的Profile设定。

添加新Profile方式：

使用spring.profiles.include属性
调用SpringApplication的setAdditionalProfiles（）方法来添加新的活动Profile

代码示例：\resources\application-addition.yml

spring:
  datasource:
    # 指定连接addition数据库
    url: jdbc:mysql://localhost:3306/ali2?serverTimezone=UTC

其他配置文件依然使用上一小节的例子，这里不再展示。

配置如下命令行参数：--spring.profiles.active=prod

主程序代码：

@SpringBootApplication
public class App
{
   public static void main(String[] args)
   {
       var app = new SpringApplication(App.class);
       // 添加Profile
       app.setAdditionalProfiles("addition");
      app.run(args);
   }
}

运行结果：

Profile组

有些情况下，我们按不同的功能组定义了多个配置文件，但这些配置文件依然应该属于一个特定的Profile。在这种需求下，可以将他们定义成Profile组。

代码示例：\resources\application-prod.yml

spring:
  datasource:
    # 指定连接prod数据库
    url: jdbc:mysql://localhost:3306/prod?serverTimezone=UTC
    username: root
    password: 32147

代码示例：\resources\application-banner.yml

# 定义图片Banner的大小
spring:
  banner:
    image:
      height: 20
      width: 60
      # 设置字符串的色深
      bitdepth: 4

代码示例：\resources\application-server.yml

server:
  port: 9090

\resources\application.yml文件内容：通过group属性来设定组。

spring:
  profiles:
    # 定义Profile组，该组还包括banner和server两个Profile
    group:
      prod:
        - banner
        - server
    # 将prod设为活动Profile
    active: prod

这里同时加载了上面的prod、banner、server三个Profile。

混合复合类型

当SpringBoot从多个配置文件中加载List类型的属性时，后加载的List集合总是完全替换先加载的List集合，比如：先加载的List集合包含2个元素，后加载的List集合包含1个元素，那么这个List属性最终只有一个元素。

当SpringBoot从多个配置文件中加载Map类型的属性时，后加载的Map的key-value对会被添加到先加载的Map中，比如：先加载的Map集合有2个key-value对，后加载的Map集合有1个key-value对，最终这个Map属性会包含3个key-value对。

代码示例：属性处理类

@ConfigurationProperties("crazyit")
public class CrazyitProperties
{
   private final List<Book> list = new ArrayList<>();
    // Book类包含了title、description属性
   private final Map<String, Book> map = new HashMap<>();
   public List<Book> getList()
   {
      return this.list;
   }
   public Map<String, Book> getMap()
   {
      return this.map;
   }
}

代码示例：\resources\application-prod.yml

spring:
  datasource:
    # 指定连接prod数据库
    url: jdbc:mysql://localhost:3306/prod?serverTimezone=UTC
    username: root
    password: 32147
crazyit:
  list:
    - title: a
      description: b
    - title: 疯狂Java讲义
      description: 北京大学信息科学学院的Java推荐教材
  map:
    prod:
      title: 产品级
      description: 产品级

代码示例：\resources\application-banner.properties

crazyit.list[0].title = 疯狂Android讲义
crazyit.list[0].description = 最全面的Adnroid编程图书
crazyit.map["banner"].title = Banner级
crazyit.map["banner"].description = Banner级

代码示例：\resources\application-server.yml

crazyit:
  list:
    - title: 疯狂Spring Boot终极讲义
      description: “此书一出再无书”的Spring Boot
  map:
    server:
      title: 服务器级
      description: 服务器级

\resources\application.yml文件内容

spring:
  profiles:
    # 定义Profile组，该组还包括banner和server两个Profile
    group:
      prod:
        - banner
        - server
    # 将prod设为活动Profile
    active: prod

这里同时加载了上面的prod、banner、server三个Profile。加载顺序为prod->banner->server。

控制器类：

@RestController
@Profile("prod")
public class ProdController
{
   private final DataSource dataSource;
   private CrazyitProperties crazyitProperties;
   @Autowired
   public ProdController(DataSource dataSource,
         CrazyitProperties crazyitProperties)
   {
      this.dataSource = dataSource;
      this.crazyitProperties = crazyitProperties;
   }
   @GetMapping
   public Map<String, Object> hello() throws SQLException
   {
      return Map.of("class", "产品场的控制器","数据库",
            dataSource.getConnection().getCatalog(),
            "crazyit", crazyitProperties);
   }
}

运行结果：

根据环境自动更新Profile

SpringBoot允许使用三个减号（---）将一份 *.yml分割成逻辑上的多个片段（ *. properties文件使用 #--- 进行分割），每个片段都会被加载成单独的配置。

当分割成多个配置之后，可通过如下属性指定“条件性”生效.

spring.config.activate.on-profile:指定此行配置以下的配置仅当指定的profile激活时才有效。改属性也支持取反运算符（!），比如“!dev”表示非dev profile时有效
spring.config.activate.on-cloud-platform:指定此行配置以下的配置仅当处于指定的云平台上时才有效

比如配置片段

myprop=always-set
#---
spring.config.activate.on-profile=prod
otherprop=prod-value

myprop的属性为always-set，总是生效。当prod Profile处于活动时，otherprop=prod-value才生效。

比如配置片段

myprop: always-set
---
spring:
  config:
    activate:
      on-cloud-platform: kubernetes
otherprop: other-set

myprop的属性为always-set，总是生效。当应用被部署在k8s云平台时，otherprop=other-set才生效。

代码示例：\resources\application.yml文件内容

spring:
  datasource:
    username: root
    password: root
---
spring:
  config:
    activate:
      on-profile: default
  datasource:
    # 指定连接deft数据库
    url: jdbc:mysql://localhost:3306/deft?serverTimezone=UTC
---
spring:
  config:
    activate:
      on-profile: dev
  datasource:
    # 指定连接dev数据库
    url: jdbc:mysql://localhost:3306/dev?serverTimezone=UTC
---
spring:
  config:
    activate:
      on-profile: prod
  datasource:
    # 指定连接prod数据库
    url: jdbc:mysql://localhost:3306/prod?serverTimezone=UTC
---
spring:
  config:
    activate:
      on-profile: test
  datasource:
    # 指定连接test数据库
    url: jdbc:mysql://localhost:3306/test?serverTimezone=UTC

不知道活动的profile，运行结果