你是不是经常遇到这样的情况？在使用 Spring Boot3 开发后端项目时，每次修改配置文件，都需要重启整个服务才能生效？线上环境频繁重启不仅麻烦，还存在服务中断的风险，极大影响用户体验。更头疼的是，随着项目规模扩大，配置项越来越多，手动管理和更新配置简直成了一场噩梦。别担心，这其实是因为你还没掌握 Spring Boot3 中动态配置的正确打开方式！

背景介绍

在当今互联网大厂的后端开发场景下，微服务架构已成为主流。一个大型项目往往由数十甚至上百个微服务组成，每个服务都有自己的配置文件。传统的静态配置方式，即配置文件一旦确定，只有重启应用才能变更，已经无法满足快速迭代、灵活部署的需求。

Spring Boot3 作为 Java 后端开发的热门框架，在动态配置方面有了诸多升级和优化。动态配置不仅能让我们在不重启服务的情况下更新配置，还能实现配置的集中化管理，提高开发和运维效率。无论是配置数据库连接参数、调整日志级别，还是修改接口限流规则，动态配置都能让这些操作变得更加便捷高效。

解决方案

使用 @RefreshScope 注解

首先，我们需要在项目中引入
spring-boot-starter-actuator依赖。在pom.xml文件中添加如下代码：

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

然后，定义一个配置类，例如MyConfig类，在类上添加@RefreshScope和@ConfigurationProperties注解：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
import org.springframework.stereotype.Component;

@Component
@RefreshScope
@ConfigurationProperties(prefix = "my.config")
@PropertySource("classpath:application.properties")
public class MyConfig {
    private String myProperty;

    public String getMyProperty() {
        return myProperty;
    }

    public void setMyProperty(String myProperty) {
        this.myProperty = myProperty;
    }
}

在application.properties文件中定义相关属性，如my.config.myProperty=initialValue。当我们修改myProperty的值后，只需要发送一个 POST 请求到/actuator/refresh接口，Spring Boot 就能自动刷新配置，并将新的值注入到MyConfig类中，无需重启服务。

结合配置中心实现集中化管理

Spring Cloud Config

搭建 Config Server 是第一步。在独立服务中，添加
spring-cloud-config-server依赖到pom.xml：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-config-server</artifactId>
</dependency>

在application.yml文件里配置 Git 仓库相关属性，比如：

server:
  port: 8888
spring:
  cloud:
    config:
      server:
        git:
          uri: https://github.com/your-git-repo
          search-paths: config-repo
          username: your-username
          password: your-password

创建带有@EnableConfigServer注解的主类，启动 Config Server。在服务应用端，添加
spring-cloud-starter-config依赖，在bootstrap.yml里配置：

spring:
  cloud:
    config:
      uri: http://localhost:8888
      name: your-application-name
      profile: dev
      label: master

同样在需要动态刷新配置的组件上加上@RefreshScope注解。当 Config Server 上的配置发生变化时，发送 POST 请求到/actuator/refresh端点，即可触发配置的动态刷新。

Nacos

在 Nacos 管理界面创建配置项，在 Spring Boot 项目中引入 Nacos 依赖：

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

在bootstrap.yml中配置
spring.cloud.nacos.config.server-addr属性，指定 Nacos 服务器地址。在相关组件上使用@RefreshScope注解。在 Nacos 管理页面修改配置并发布后，Spring Boot 会自动刷新对应的配置。

Spring Cloud Bus 和 RefreshEndpoint

添加
spring-cloud-starter-bus-amqp依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bus-amqp</artifactId>
</dependency>

配置好 RabbitMQ 连接信息，在代码里通过调用RefreshEndpoint的refresh方法，就能实现配置更新的推送和动态刷新。

Spring Cloud Config Watch

添加
spring-cloud-starter-config依赖后，在bootstrap.properties里配置好 Spring Cloud Config Server 的地址，在application.properties里设置
spring.cloud.config.watch.refresh-interval属性指定刷新间隔。启用后，配置文件的变更会定时从配置中心获取并更新到应用中。

总结

掌握 Spring Boot3 的动态配置技术，能让我们在后端开发工作中事半功倍，告别繁琐的手动重启和低效的配置管理。无论是使用简单的@RefreshScope注解，还是结合功能强大的配置中心，都需要大家在实际项目中多实践、多尝试。

如果你在使用 Spring Boot3 动态配置过程中遇到了问题，或者有更好的实践经验，欢迎在评论区留言分享！也别忘了点赞、收藏这篇文章，方便以后随时查阅。要是觉得文章对你有帮助，还可以转发给身边同样在做后端开发的小伙伴哦！