如何在Spring Boot应用中通过端点运行时覆盖application.properties配置

一、动态修改自身项目的xyz_FLAG配置 #

方案1：利用Spring Boot Actuator的/env端点 #

1. 在项目依赖中引入Actuator：

<!-- Maven -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

// Gradle
implementation 'org.springframework.boot:spring-boot-starter-actuator'

2. 在application.properties中开启端点的读写权限：

management.endpoints.web.exposure.include=env,restart
management.endpoint.env.post.enabled=true
management.endpoint.restart.enabled=true

3. 发送POST请求修改配置，再重启上下文生效：

# 修改配置
curl -X POST http://localhost:8080/actuator/env \
  -H "Content-Type: application/json" \
  -d '{"name":"xyz_FLAG","value":"true"}'

# 重启上下文使配置生效
curl -X POST http://localhost:8080/actuator/restart

方案2：自定义端点实现灵活控制 #

1. 创建自定义控制器，结合上下文刷新实现配置修改：

import org.springframework.cloud.context.refresh.ContextRefresher;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ConfigToggleController {

    private final ContextRefresher contextRefresher;

    public ConfigToggleController(ContextRefresher contextRefresher) {
        this.contextRefresher = contextRefresher;
    }

    @PostMapping("/toggle-xyz-flag")
    public String toggleXyzFlag(@RequestParam boolean value) {
        System.setProperty("xyz_FLAG", String.valueOf(value));
        contextRefresher.refresh();
        return "xyz_FLAG已设置为: " + value;
    }
}

2. 引入Spring Cloud Context依赖用于上下文刷新：

<!-- Maven -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-context</artifactId>
</dependency>

3. 调用自定义端点修改配置：

curl -X POST "http://localhost:8080/toggle-xyz-flag?value=true"

二、动态修改依赖EY项目的xyz_FLAG配置 #

EY项目的配置会被加载到当前应用的环境中，只需确认其配置键名称（若EY项目配置无前缀则为xyz_FLAG，有前缀则为类似ey.xyz_FLAG的格式），再通过以下方式修改：

方法1：通过Actuator的/env端点修改 #

# 假设EY项目配置键为ey.xyz_FLAG
curl -X POST http://localhost:8080/actuator/env \
  -H "Content-Type: application/json" \
  -d '{"name":"ey.xyz_FLAG","value":"true"}'

# 重启上下文生效
curl -X POST http://localhost:8080/actuator/restart

方法2：在自定义端点中扩展接口 #

在之前的ConfigToggleController中添加如下接口：

@PostMapping("/toggle-ey-xyz-flag")
public String toggleEyXyzFlag(@RequestParam boolean value) {
    System.setProperty("ey.xyz_FLAG", String.valueOf(value)); // 替换为EY项目实际配置键
    contextRefresher.refresh();
    return "EY项目的xyz_FLAG已设置为: " + value;
}

调用该端点完成修改：

curl -X POST "http://localhost:8080/toggle-ey-xyz-flag?value=true"

注意事项 #

• 若EY项目的配置通过@ConfigurationProperties绑定，需确保对应配置类添加@RefreshScope注解，这样配置修改后无需重启整个应用，仅刷新上下文即可生效。
• 生产环境需为这些端点添加权限校验，防止未授权访问。

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