SpringBoot 2应用无法加载bootstrap.yml配置项求助

问题场景 #

我在实现从bootstrap.yml读取配置到配置类时遇到启动报错，具体情况：

• 已配置/src/main/resources/META-INF/spring.factories，指定BootstrapConfiguration=com.xyz.config.BootStrapConfig
• /src/main/resources/bootstrap.yml包含spring.cloud.bootstrap.enabled: true及aws.service.name等配置项
• Gradle依赖已引入Spring Boot、Spring Cloud相关包
• com.xyz.config.BootStrapConfig类用@Value("${aws.service.name}")注入配置
• 主启动类XYZIntegrationApplication通过SpringApplicationBuilder指定spring.config.location

Gradle构建成功，但本地启动抛BeanCreationException，提示无法解析占位符aws.service.name。

排查与解决方法 #

1. 修复Spring Cloud版本的Bootstrap兼容性问题 #

Spring Cloud 2020.0.0（Ilford版本）及之后，默认禁用了Bootstrap上下文机制。即使在bootstrap.yml中配置spring.cloud.bootstrap.enabled: true，也需要额外引入依赖才能启用：
在build.gradle中添加：

implementation 'org.springframework.cloud:spring-cloud-starter-bootstrap'

添加后重新构建项目，确保依赖生效。

2. 修正spring.config.location的路径配置 #

主启动类通过SpringApplicationBuilder指定spring.config.location时，可能覆盖了默认的bootstrap.yml加载路径。需要显式保留默认配置目录，或者将bootstrap.yml所在路径加入配置：
修改启动类代码：

new SpringApplicationBuilder(XYZIntegrationApplication.class)
    .properties("spring.config.location=classpath:/,classpath:/config/,file:./,file:./config/")
    .run(args);

如果是自定义配置路径，确保包含classpath:/（bootstrap.yml默认所在的根目录）。

3. 检查BootStrapConfig类与spring.factories的配置正确性 #

• 确保BootStrapConfig类添加了@Configuration注解：

@Configuration
public class BootStrapConfig {
    @Value("${aws.service.name}")
    private String awsServiceName;
    // 其他业务代码
}

• 验证spring.factories的格式与类路径无拼写错误：

org.springframework.cloud.bootstrap.BootstrapConfiguration=\
com.xyz.config.BootStrapConfig

注意换行符\和全类名的准确性。

4. 校验bootstrap.yml的配置格式 #

确保aws.service.name的配置符合YAML规范，无缩进或拼写错误：

spring:
  cloud:
    bootstrap:
      enabled: true
aws:
  service:
    name: your-target-service-name

YAML使用空格缩进（禁止用制表符），层级必须正确对齐。

5. 确认Bootstrap上下文的加载优先级 #

Bootstrap上下文需优先于主应用上下文加载，若BootStrapConfig被主上下文提前初始化，会导致配置未就绪。可通过spring.factories的方式确保类属于Bootstrap上下文，或添加@DependsOn("bootstrapContext")注解强制依赖顺序。

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