讲师中心 微信公众号
AI工具推荐 视频效率加速

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

夏芳同学_3183

夏芳同学_3183

发布时间:2026-08-08 11:36:24

|

954人浏览过

|

来源于php中文网

原创

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;
    }
}

注册方式(两种均可):

  • 方式一:代码中注册

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

    Java调试
    Java调试

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

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

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


✅ 运行时通过 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() 控制覆盖行为。

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
java
java

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

11937

2023.06.15

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

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

9022

2023.07.05

java自学难吗
java自学难吗

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

7732

2023.07.31

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

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

1264

2023.08.01

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

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

1008

2023.08.02

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

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

1516

2023.08.02

java有什么用
java有什么用

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

3129

2023.08.02

java在线网站
java在线网站

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

20371

2023.08.03

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

0

2026.11.05

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn