背景说明

在中小型 Spring Boot 项目中，引入完整的配置中心（如 Nacos、Apollo 或 Spring Cloud Config）往往显得过于复杂和资源消耗大。然而，仍存在动态更新配置而不重启应用的需求。本文介绍两种无需配置中心即可实现配置热加载的轻量级方法。

方案一：通过 ContextRefresher 手动触发刷新

利用 org.springframework.cloud.context.refresh.ContextRefresher 类，可以在运行时手动重新加载带有外部配置属性的 Bean。

1. 添加依赖

需要引入 spring-cloud-context 模块，注意版本需与当前 Spring Boot 版本兼容：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-context</artifactId>
    <version>3.1.5</version> <!-- 示例版本，请根据 Spring Boot 版本调整 -->
</dependency>

2. 定义可刷新配置类

使用 @RefreshScope 注解标记 Bean，使其支持刷新：

@Component
@RefreshScope
@Data
public class LoginConfig {
    @Value("${login.attempt.maxRetries}")
    private Integer maxRetries;

    @Value("${login.attempt.lockDurationSeconds}")
    private Integer lockDurationSeconds;
}

或者采用类型安全的方式：

@Configuration
@ConfigurationProperties(prefix = "login.attempt")
@Data
public class LoginAttemptProperties {
    private Integer maxRetries;
    private Integer lockDurationSeconds;
}

注意： 使用 @ConfigurationProperties 时，无需添加 @RefreshScope，因为该注解本身已被 Spring Cloud 自动代理支持刷新。

3. 提供刷新接口

@RestController
@RequestMapping("/config")
public class ConfigController {

    @Autowired
    private LoginConfig loginConfig;

    @Autowired
    private ContextRefresher contextRefresher;

    @GetMapping("/current")
    public String getCurrentConfig() {
        return loginConfig.toString();
    }

    @PostMapping("/reload")
    public String reloadConfig() {
        // 异步执行刷新，避免阻塞 HTTP 请求线程
        new Thread(contextRefresher::refresh).start();
        return "Refresh triggered, current: " + loginConfig.toString();
    }
}

方案二：通过 Actuator Endpoint 实现远程刷新

结合 Spring Boot Actuator 的 /actuator/refresh 端点，可以接收外部请求并触发配置重载。

1. 引入 Actuator 依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-context</artifactId>
    <version>3.1.5</version>
</dependency>

2. 配置暴露端点

在 application.yml 中启用并暴露 refresh 端点：

management:
  server:
    port: 8081  # 使用独立管理端口
  endpoints:
    web:
      exposure:
        include: "*"  # 开放所有端点（生产环境建议精确控制）
  endpoint:
    refresh:
      enabled: true

3. 调用刷新接口

发送 POST 请求至 /actuator/refresh，可携带新的配置值（仅限部分支持场景）：

curl -X POST http://localhost:8081/actuator/refresh \
  -H "Content-Type: application/json" \
  -d '{
        "login.attempt.maxRetries": 50,
        "login.attempt.lockDurationSeconds": 600
      }'

响应将返回实际变更的属性列表，例如：

[
  "config.client.requestTimeout",
  "login.attempt.maxRetries"
]

4. 注意事项

• Actuator 的 refresh 端点主要设计用于从外部源（如文件系统、Git）重新加载配置，直接传参更新功能有限，通常依赖于底层 Environment 的可变性。
• 生产环境中应限制端点访问权限，防止未授权操作。
• 建议结合 @ConfigurationProperties 和自动刷新机制，确保类型安全与一致性。