Spring Boot 中怎么使用 SpringApplication 动态修改配置

夏芳同学_3183

夏芳同学_3183

2026-08-08

954人浏览

原创

Spring Boot 动态修改配置分启动前和运行时两种:启动前通过 ApplicationContextInitializer 在 Environment 初始化阶段注入配置;运行时通过 ConfigurableEnvironment 修改,但需配合 @RefreshScope 和 /actuator/refresh 实现 Bean 级热刷新。

spring boot 中怎么使用 springapplication 动态修改配置

Spring Boot 中通过 SpringApplication 动态修改配置,核心思路是在应用启动前(即 ApplicationContext 初始化之前)干预 Environment,向其中注入或覆盖配置项。这种方式不依赖外部配置中心,也不需要重启服务,适用于启动时从数据库、远程 API、环境变量等动态加载并生效配置。

关键点在于:必须在 ApplicationContext 创建前完成修改,否则 @Value、@ConfigurationProperties 等注解已绑定旧值,后续修改无效。


✅ 在 SpringApplication.run() 之前修改 Environment

最常用且可靠的方式是添加 ApplicationContextInitializer 或自定义 SpringApplicationRunListener,在 ApplicationEnvironmentPreparedEvent 阶段操作 MutablePropertySources。

示例:启动时从数据库加载配置并覆盖默认值

public class DatabaseConfigInitializer implements ApplicationContextInitializer<configurableapplicationcontext> {
    @Override
    public void initialize(ConfigurableApplicationContext applicationContext) {
        ConfigurableEnvironment environment = applicationContext.getEnvironment();
        MutablePropertySources propertySources = environment.getPropertySources();

        // 模拟从数据库读取 key-value 配置(注意:此处需确保 JDBC 可用,且不依赖已初始化的 DataSource Bean)
        Map<string string> dbConfigs = loadFromDatabase(); // 自行实现 JDBC 查询逻辑

        // 构建自定义 PropertySource 并前置插入(优先级最高)
        MapPropertySource customSource = new MapPropertySource("db-config", dbConfigs);
        propertySources.addFirst(customSource);
    }

    private Map<string string> loadFromDatabase() {
        // 使用 DriverManager 或轻量 JdbcTemplate(避免依赖 Spring 容器)
        // 示例 SQL:SELECT `key`, `value` FROM sys_config WHERE enabled = 1
        Map<string string> map = new HashMap();
        // ... 执行查询并填充 map
        return map;
    }
}</string></string></string></configurableapplicationcontext>

注册方式(两种均可):

  • 方式一:代码中注册

    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(MyApplication.class);
        app.addInitializers(new DatabaseConfigInitializer());
        app.run(args);
    }
  • 方式二:META-INF/spring.factories

    org.springframework.context.ApplicationContextInitializer=\
    com.example.DatabaseConfigInitializer

⚠️ 注意:该方法只能在启动阶段一次性加载,不是运行时热更新。若需运行时修改,请配合 ConfigurableEnvironment + MutablePropertySources.addOrReplace()(见下文)。

Java调试
Java调试

通过 JDWP 实现 Java 远程调试:连接远程 JVM、设置断点、单步执行代码、查看变量值、获取调用栈。适用于需要调试远程 Java 应用、排查运行时状态、追踪代码执行流程的场景。 术语注解 JDWP:Java Debug Wire Protocol,Java 调试有线协议(Java 远程调试底层通信协议) remote JVM:远程 Java 虚拟机 step through code:代码单步调试(步入 / 步过 / 步出调试) inspect variables:变量查看 / 变量检视 stac

下载

✅ 运行时通过 ConfigurableEnvironment 修改配置(有限制)

Spring Boot 允许在应用运行中直接操作 Environment,但需注意:

  • @Value 注入的字段不会自动刷新(除非配合 @RefreshScope);
  • @ConfigurationProperties 类需加 @RefreshScope 或使用 @ConfigurationPropertiesRefresh(Spring Boot 2.4+);
  • 修改后仅对新创建的 Bean 或显式调用 environment.getProperty() 生效。
@Component
public class RuntimeConfigUpdater {

    private final ConfigurableEnvironment environment;

    public RuntimeConfigUpdater(ConfigurableEnvironment environment) {
        this.environment = environment;
    }

    public void setProperty(String key, String value) {
        MutablePropertySources sources = environment.getPropertySources();
        // 替换或新增:addLast 优先级低,addFirst 优先级高(覆盖原有)
        sources.addFirst(new MapPropertySource("runtime", Collections.singletonMap(key, value)));
    }
}

调用示例(如通过 HTTP 接口):

@RestController
public class ConfigController {

    private final RuntimeConfigUpdater updater;

    public ConfigController(RuntimeConfigUpdater updater) {
        this.updater = updater;
    }

    @PostMapping("/config/update")
    public String update(@RequestParam String key, @RequestParam String value) {
        updater.setProperty(key, value);
        return "OK";
    }
}

✅ 适用场景:灰度开关、调试参数、临时降级配置
❌ 不适用:已注入 @Value 的字段值不会变;@ConfigurationProperties 对象需手动刷新或重启 Bean。


✅ 结合 @RefreshScope 实现 Bean 级热刷新(推荐组合)

若你希望修改配置后,相关 Bean 自动重新初始化(比如 @Service 中的 @Value 字段更新),需:

  1. 给目标 Bean 加 @RefreshScope;
  2. 修改 Environment(如上);
  3. 触发刷新(Spring Boot Actuator 的 /actuator/refresh)——但注意:这属于 Spring Cloud 生态功能,需引入 spring-cloud-starter 和 spring-boot-starter-actuator,并开启端点。
# application.yml
management:
  endpoints:
    web:
      exposure:
        include: refresh
curl -X POST http://localhost:8080/actuator/refresh

此时带 @RefreshScope 的 Bean 会被销毁重建,重新注入最新配置值。


✅ 小结:不同场景对应方法

  • 启动前加载外部配置(如 DB、Consul) → ApplicationContextInitializer
  • 运行时临时覆盖某几个 key → 直接操作 ConfigurableEnvironment.getPropertySources()
  • 希望 Bean 自动响应变更 → @RefreshScope + Actuator /refresh
  • 多实例集群统一配置 → 必须搭配 Spring Cloud Config / Nacos / Apollo 等配置中心
  • 修改 server.port、spring.profiles.active 等启动参数 → 只能通过命令行 --server.port=9000 或系统属性 -Dspring.profiles.active=prod,无法运行时改(嵌入式容器已初始化)

不复杂但容易忽略:所有动态修改都依赖“配置源优先级”机制——后加入的 PropertySource 会覆盖前面同名 key。合理使用 addFirst() 或 addLast() 控制覆盖行为。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java spring boot

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11957

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9062

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7752

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1264

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1008

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1516

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3129

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20371

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1375

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习