如何让Spring Boot默认使用指定Profile并解决mvn install报错问题

我正在运行一个Spring Boot应用，希望无需VM参数就能默认指定Profile，同时让mvn install默认使用该Profile。

当前配置 #

bootstrap配置 #

# my bootstrap
spring:
  config:
    activate:
      on-profile: local
  cloud:
    vault:
      enabled: false

---
spring:
  config:
    activate:
      on-profile: local

---
spring:
  config:
    activate:
      on-profile: it
  cloud:
    vault:
      enabled: true

pom.xml文件 #

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.0</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.example</groupId>
    <artifactId>Spring-vault-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>Spring-vault-demo</name>
    <description>Spring-vault-demo</description>
    <properties>
        <java.version>17</java.version>
    </properties>

    <dependencyManagement>
        <dependencies>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

        <!--  my vault-->
        <dependency>
            <groupId>org.springframework.vault</groupId>
            <artifactId>spring-vault-core</artifactId>
            <version>3.0.2</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-vault-config</artifactId>
            <version>4.0.1</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-bootstrap</artifactId>
            <version>4.0.3</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-vault-config</artifactId>
            <version>4.0.1</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-failsafe-plugin</artifactId>
                <configuration>
                    <systemPropertyVariables>
                        <argline>Dspring.profiles.active=it</argline>
                    </systemPropertyVariables>
                    <skipTests>false</skipTests>
                </configuration>
                <executions>
                    <execution>
                        <id>it</id>
                        <goals>
                            <goal>integration-test</goal>
                            <goal>verify</goal>
                        </goals>
                        <phase>integration-test</phase>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>

</project>

遇到的错误 #

org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'vaultPropertySourceLocator' defined in class path resource [org/springframework/cloud/vault/config/VaultBootstrapPropertySourceConfiguration.class]: Unsatisfied dependency expressed through method 'vaultPropertySourceLocator' parameter 0: Error creating bean with name 'vaultTemplate' defined in class path resource [org/springframework/cloud/vault/config/VaultBootstrapConfiguration.class]: Failed to instantiate [org.springframework.vault.core.VaultTemplate]: Factory method 'vaultTemplate' threw exception with message: Error creating bean with name 'vaultSessionManager' defined in class path resource [org/springframework/cloud/vault/config/VaultBootstrapConfiguration.class]: Unsatisfied dependency expressed through method 'vaultSessionManager' parameter 0: Error creating bean with name 'clientAuthentication' defined in class path resource [org/springframework/cloud/vault/config/VaultBootstrapConfiguration.class]: Failed to instantiate [org.springframework.vault.authentication.ClientAuthentication]: Factory method 'clientAuthentication' threw exception with message: Cannot create authentication mechanism for TOKEN. This method requires either a Token (spring.cloud.vault.token) or a token file at ~/.vault-token.

已尝试的方案 #

1. 在pom.xml中添加默认Profile配置：

<profiles>
    <profile>
        <id>default</id>
        <properties>
            <spring.profiles.active>local</spring.profiles.active>
        </properties>
    </profile>
</profiles>

2. 在application.properties中设置spring.profiles.active=local

两种方式均无效，调试发现BootstrapApplicationListener的active profile列表为空。目前通过mvn spring-boot:run可以运行local profile，但执行mvn install时仍出现上述错误。

1. 问题根源 #

由于使用了Spring Cloud Bootstrap，启动阶段配置加载优先级为bootstrap.yml/properties > application.yml/properties，默认Profile必须在Bootstrap阶段生效，否则Vault自动配置会在Profile激活前触发，导致认证错误。

2. 修正Bootstrap配置，设置默认Profile #

在bootstrap.yml的公共区块（不归属任何Profile的部分）添加默认激活的Profile，确保Bootstrap阶段直接启用local：

# 公共配置：默认激活local profile
spring:
  profiles:
    active: local

---
spring:
  config:
    activate:
      on-profile: local
  cloud:
    vault:
      enabled: false

---
spring:
  config:
    activate:
      on-profile: it
  cloud:
    vault:
      enabled: true

3. 调整Maven配置，确保install阶段使用默认Profile #

方式一：配置Spring Boot Maven Plugin传递参数

在spring-boot-maven-plugin中添加默认系统属性，保证打包/运行时传递Profile：

<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <systemProperties>
            <spring.profiles.active>local</spring.profiles.active>
        </systemProperties>
    </configuration>
</plugin>

方式二：修正Maven默认Profile激活逻辑

将Maven Profile设置为默认激活，同时保留it Profile用于集成测试：

<profiles>
    <profile>
        <id>local</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <properties>
            <spring.profiles.active>local</spring.profiles.active>
        </properties>
    </profile>
    <profile>
        <id>it</id>
        <properties>
            <spring.profiles.active>it</spring.profiles.active>
        </properties>
    </profile>
</profiles>

同时修正maven-failsafe-plugin配置，确保集成测试时切换到it Profile：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-failsafe-plugin</artifactId>
    <configuration>
        <systemPropertyVariables>
            <spring.profiles.active>it</spring.profiles.active>
        </systemPropertyVariables>
        <skipTests>false</skipTests>
    </configuration>
    <executions>
        <execution>
            <id>it</id>
            <goals>
                <goal>integration-test</goal>
                <goal>verify</goal>
            </goals>
            <phase>integration-test</phase>
        </execution>
    </executions>
</plugin>

4. 验证效果 #

• 执行mvn install：默认激活local Profile，Vault禁用，无报错
• 集成测试阶段：maven-failsafe-plugin自动切换到it Profile
• 直接运行应用：无需VM参数，默认使用local Profile

内容的提问来源于stack exchange，提问作者RAy