问题记录_SpringCloud：版本升级后bootstrap.yml配置失效

最新推荐文章于 2025-06-04 10:03:23 发布

原创最新推荐文章于 2025-06-04 10:03:23 发布 · 2.5k 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#SpringCloud #bootstrap.yml失效

问题记录专栏收录该内容

3 篇文章

订阅专栏

本文档介绍了在升级SpringAlibabaCloud项目到SpringBoot2.4后遇到的应用服务启动失败的问题，原因在于SpringBoot从2.4版本开始配置加载方式的改变。解决方案包括引入`spring-cloud-starter-bootstrap`依赖或者通过设置运行参数`spring.cloud.bootstrap.enabled=true`来启用。按照提供的方案调整后，应用服务可以成功启动。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

问题描述

开发的Spring Alibaba Cloud项目，依照阿里巴巴官方提供的毕业依赖关系做了依赖版本的升级，升级后启动应用服务失败。发现bootstrap.yml中所配置的信息都没有生效。

问题的原因

网上搜了一下，从Spring Boot 2.4版本开始，配置文件加载方式进行了重构。

另外也有配置的默认值变化，原来默认启用 true 现在变更为 false 如下：

version:2.4之前

package org.springframework.cloud.bootstrap;
public class BootstrapApplicationListener implements ApplicationListener<ApplicationEnvironmentPreparedEvent>, Ordered {
    public void onApplicationEvent(ApplicationEnvironmentPreparedEvent event) {
        ConfigurableEnvironment environment = event.getEnvironment();
        if ((Boolean)environment.getProperty("spring.cloud.bootstrap.enabled", Boolean.class, true)) {
        }
    }
}

version:2.4.2

package org.springframework.cloud.util;
public abstract class PropertyUtils {
    public static boolean bootstrapEnabled(Environment environment) {
        return (Boolean)environment.getProperty("spring.cloud.bootstrap.enabled", Boolean.class, false) || MARKER_CLASS_EXISTS;
    }
}

解决方案：传统的解决方案

官方文档：点击访问

方案1：引用依赖

pom.xml中引用 spring-cloud-starter-bootstrap 依赖

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

可以在maven仓库中自行找对应的版本信息

方案2：指定运行参数

指定参数 spring.cloud.bootstrap.enabled 值为 true

IDEA中：
spring.cloud.bootstrap.enabled=true
--- 
命令行: 
java -jar -Dspring.cloud.bootstrap.enabled=true test.jar

配置完成后再次启动即可成功运行