Spring Cloud默认弃用bootstrap.yml的原因及替代方案等问题咨询

项目环境配置 #

基于Java 1.8搭建的Spring Cloud测试项目，核心依赖版本如下：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    <java.version>1.8</java.version>
    <mysql.version>8.0.30</mysql.version>
    <mybatis.version>3.0.0</mybatis.version>
    <mybatis-plus.version>3.5.2</mybatis.version>
    <spring-boot.version>2.6.11</spring-boot.version>
    <spring-cloud.version>2021.0.4</spring-cloud.version>
    <spring-cloud-alibaba.version>2021.0.4.0</spring-cloud-alibaba.version>
    <alibaba.nacos.version>2.0.4</alibaba.nacos.version>
    <freemarker.version>2.3.31</freemarker.version>
    <swagger.version>1.6.2</swagger.version>
    <lombok.version>1.18.8</lombok.version>
    <openfeign.version>3.1.5</openfeign.version>
    <loadbalance.version>3.1.4</loadbalance.version>
</properties>

遇到的问题 #

order和user模块通过bootstrap.yml配置服务名称与Nacos可正常生效，但gateway模块在bootstrap.yml中配置端口10010无效，始终以8080启动；改用application.yml配置则正常生效。

已知Spring Boot 2.4.0后默认禁用bootstrap.yml，针对此场景有三个疑问及解答：

1. 若bootstrap已被弃用，为何order和user模块仍可正常使用？ #

大概率是这两个模块间接引入了spring-cloud-starter-bootstrap依赖。比如部分Spring Cloud Alibaba组件（如Nacos Discovery/Config）在旧版本中会默认传递引入该依赖，让bootstrap.yml仍能被加载。而gateway模块的依赖树中没有这个依赖，所以无法识别bootstrap.yml。可以执行mvn dependency:tree命令对比两个模块的依赖差异，确认是否存在该依赖。

2. 如何优雅替代bootstrap.yml？ #

修正spring.config.import配置格式

你当前的配置写法有误，正确格式需要将config.import放在spring节点下，且optional:是前缀，无需拆分。示例：

spring:
  config:
    import:
      - optional:nacos:order-dev.yaml
      - nacos:order-dev.yaml

IDEA的提示属于编辑器识别问题，不影响实际运行。如果要消除提示，可以升级Spring Cloud相关的IDEA插件版本，或在配置文件顶部添加# @springboot.config.ignore注释忽略检查。

其他替代方案

• 环境分层配置：通过spring.profiles.active指定环境，结合application-{profile}.yml实现多环境配置，配合Nacos的环境隔离功能使用。
• 自定义配置加载逻辑：若需要在启动早期加载配置，可通过ApplicationListener<ApplicationEnvironmentPreparedEvent>自定义逻辑，在环境初始化阶段读取外部配置源。

3. Spring为何要禁用bootstrap.yml？ #

主要原因有三点：

• 统一配置模型：bootstrap.yml是Spring Cloud单独引入的早期配置加载机制，与Spring Boot原生配置模型不一致，增加了理解和维护成本。禁用后统一使用spring.config.import，让配置加载逻辑更统一。
• 简化启动流程：bootstrap阶段的存在让启动流程分为两个阶段，增加了复杂度。移除后可简化应用启动生命周期，减少潜在冲突。
• 增强扩展性：spring.config.import支持更灵活的配置源扩展，不仅兼容Nacos、Consul等配置中心，还支持自定义配置源实现，比原bootstrap机制更灵活。

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