Spring Boot 3中bootstrap.yaml配置属性值被覆盖问题求助

问题复现 #

升级至Spring Boot 3后，启动应用时指定dev环境，ConfigServer却始终连接QA环境的URL——最后声明的环境配置会覆盖前面的配置。该配置在Spring Boot 2.7.X版本中可正常工作，添加spring-boot-properties-migrator依赖后能临时解决问题，但该依赖不建议用于生产环境。

原核心配置（application.yml）：

spring:
  application:
    name: appname
  profiles:
    active: ${spring.profiles.active}
    include:
      - global-defaults
    group:
      dev:
        - config-server-dev
        - cloud-config-dev
      qa:
        - config-server-qa
        - cloud-config-qa

---

spring:
  config:
    activate:
      on-profile: config-server-dev
  cloud:
    config:
      enabled: true
      uri: http://urltoconfigserverdev
      label: master

---

spring:
  config:
    activate:
      on-profile: config-server-qa
  cloud:
    config:
      enabled: true
      uri: http://urltoconfigserverqa
      label: master

临时依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

原因分析 #

Spring Boot 3对配置加载逻辑、Profile条件激活的优先级做了调整，相较于2.7.X版本，同一配置文件中多片段的条件加载规则更严格。同时，spring.profiles.active=${spring.profiles.active}这种循环引用式的配置，可能导致初始化阶段Profile识别异常，使得所有配置片段被加载，最终后声明的配置覆盖前面的。此外，Spring Boot 3对应Spring Cloud 2022.0.x版本，若依赖版本不匹配也可能触发此类问题。

解决方案 #

方案1：修正Profile激活配置，避免循环引用 #

移除配置文件中spring.profiles.active=${spring.profiles.active}的循环配置，改为启动时通过外部参数指定激活的Profile，例如：

java -jar your-app.jar --spring.profiles.active=dev

方案2：拆分配置文件，按Profile隔离配置 #

将不同环境的ConfigServer配置拆分到独立的配置文件中，避免同一文件内的片段覆盖：

• 创建application-config-server-dev.yml：

spring:
  cloud:
    config:
      enabled: true
      uri: http://urltoconfigserverdev
      label: master

• 创建application-config-server-qa.yml：

spring:
  cloud:
    config:
      enabled: true
      uri: http://urltoconfigserverqa
      label: master

原application.yml保持Profile组配置不变即可，Spring Boot会根据激活的Profile自动加载对应文件的配置。

方案3：调整配置片段的条件激活逻辑 #

修改同一配置文件内的片段，直接绑定到环境主Profile而非子Profile，简化激活逻辑：

spring:
  application:
    name: appname
  profiles:
    include:
      - global-defaults
    group:
      dev:
        - cloud-config-dev
      qa:
        - cloud-config-qa

---

spring:
  config:
    activate:
      on-profile: dev
  cloud:
    config:
      enabled: true
      uri: http://urltoconfigserverdev
      label: master

---

spring:
  config:
    activate:
      on-profile: qa
  cloud:
    config:
      enabled: true
      uri: http://urltoconfigserverqa
      label: master

方案4：确认Spring Cloud版本兼容性 #

确保Spring Cloud版本与Spring Boot 3匹配（对应版本为2022.0.x），在pom.xml中锁定版本：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-dependencies</artifactId>
            <version>2022.0.4</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

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