IntelliJ中SpringBoot指定local profile后bootstrap-local.yml未加载问题

问题场景 #

本地开发Spring Boot应用时，我创建了application-local.yml和bootstrap-local.yml，按照官方文档在IntelliJ中设置active profile为local后，只有application-local.yml生效，bootstrap-local.yml完全没被加载，默认的bootstrap.yml仍然在起作用。尝试通过环境变量设置profile也没效果，项目中已引入spring-cloud-gcp-starter依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-gcp-starter</artifactId>
</dependency>

问题原因 #

从Spring Cloud 2020.0.x（代号Ilford）版本开始，bootstrap上下文默认不再自动启用。而spring-cloud-gcp-starter依赖的Spring Cloud版本如果属于这个范围，就会导致带profile的bootstrap配置文件无法被自动识别加载，只会加载默认的bootstrap.yml。

解决步骤 #

1. 添加bootstrap启动依赖
   在pom.xml中引入spring-cloud-starter-bootstrap，强制开启bootstrap上下文的加载逻辑：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

2. 确认Profile激活配置
   检查IntelliJ中的Profile设置是否正确：

• 打开「Run/Debug Configurations」→ 选中你的Spring Boot应用 → 切换到「Configuration」标签页，在「Environment」区域的「Active profiles」输入框中填写local
• 或者在VM options中添加参数：-Dspring.profiles.active=local
• 也可以在application-local.yml中配置：spring.profiles.active: local（推荐用IDE配置，更灵活）

3. 验证bootstrap配置语法与优先级
   bootstrap配置的加载顺序是bootstrap.yml → bootstrap-{profile}.yml，后者会覆盖前者的相同配置项。务必检查bootstrap-local.yml的YAML语法（比如缩进、冒号后空格）是否正确，避免因语法错误导致配置不生效。

4. 核对版本兼容性
   确保spring-cloud-gcp-starter的版本和你的Spring Boot版本匹配，比如Spring Boot 2.4.x对应Spring Cloud 2020.0.x，Spring Boot 2.5.x对应Spring Cloud 2021.0.x，版本不兼容也可能引发配置加载异常。

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