Spring运行时如何无需重启Docker重新读取服务器上的application.yml？

方案一：使用Spring Boot Actuator + @RefreshScope（单实例首选） #

这是最常用的轻量方案，步骤如下：

• 引入Actuator依赖
  Maven项目在pom.xml中添加：

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

  Gradle项目在build.gradle中添加：

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

• 配置Actuator端点
  在外部的application.yml中添加：

  management:
    endpoints:
      web:
        exposure:
          include: refresh  # 暴露refresh端点
    endpoint:
      refresh:
        enabled: true  # 开启refresh端点
  

• 标记需要动态刷新的Bean
  在读取配置的类上添加@RefreshScope注解，比如配置类或者业务Bean：

  @RefreshScope
  @ConfigurationProperties(prefix = "your.config.prefix")
  public class YourConfig {
      // 配置字段
      private String someProperty;
      // getter/setter
  }
  

• 触发配置刷新
  修改服务器上的application.yml后，发送POST请求到应用的/actuator/refresh端点（注意端口和上下文路径），比如用curl：

  curl -X POST http://your-app-ip:port/actuator/refresh
  

方案二：使用Spring Cloud Bus（多实例场景） #

如果是多实例部署，用这个方案可以一次请求刷新所有实例：

• 引入依赖
  除了Actuator，还要加Spring Cloud Bus和对应的消息队列依赖（以RabbitMQ为例）：
  Maven：

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

• 配置消息队列和Bus端点
  在application.yml中添加RabbitMQ配置和Bus端点暴露：

  spring:
    rabbitmq:
      host: your-rabbitmq-host
      port: 5672
      username: username
      password: password
  management:
    endpoints:
      web:
        exposure:
          include: bus-refresh
  

• 触发批量刷新
  修改配置后，发送POST请求到/actuator/bus-refresh，所有连接到同一消息队列的实例都会自动刷新配置。

方案三：自定义文件监听（无依赖轻量化） #

如果不想引入额外依赖，可以自己实现文件监听逻辑：

• 编写文件监听组件
  用Java的WatchService监听application.yml的变化，当文件修改时，手动刷新Spring的Environment：

  @Component
  public class ConfigFileWatcher implements ApplicationListener<ApplicationReadyEvent> {
      private final Environment environment;
      private final String configPath = "/path/to/application.yml"; // 容器内的配置文件路径
  
      public ConfigFileWatcher(Environment environment) {
          this.environment = environment;
      }
  
      @Override
      public void onApplicationEvent(ApplicationReadyEvent event) {
          try {
              WatchService watchService = FileSystems.getDefault().newWatchService();
              Path path = Paths.get(configPath).getParent();
              path.register(watchService, StandardWatchEventKinds.ENTRY_MODIFY);
  
              new Thread(() -> {
                  while (true) {
                      WatchKey key;
                      try {
                          key = watchService.take();
                          for (WatchEvent<?> eventItem : key.pollEvents()) {
                              if (eventItem.context().toString().equals("application.yml")) {
                                  // 刷新配置
                                  if (environment instanceof ConfigurableEnvironment) {
                                      MutablePropertySources sources = ((ConfigurableEnvironment) environment).getPropertySources();
                                      sources.remove("applicationConfig: [classpath:/application.yml]");
                                      YamlPropertySourceLoader loader = new YamlPropertySourceLoader();
                                      PropertySource<?> source = loader.load("application.yml", new FileSystemResource(configPath), null);
                                      sources.addFirst(source);
                                  }
                              }
                          }
                          key.reset();
                      } catch (Exception e) {
                          e.printStackTrace();
                      }
                  }
              }).start();
          } catch (IOException e) {
              e.printStackTrace();
          }
      }
  }
  

  注意：这个方法需要手动处理配置源的替换，适合简单场景，复杂配置可能需要调整。

关键前提：Docker配置文件挂载 #

不管用哪种方案，必须确保服务器上的application.yml挂载到Docker容器内的对应路径，比如启动容器时用：

docker run -v /server/path/application.yml:/app/application.yml your-spring-app-image

这样修改服务器上的文件时，容器内的配置文件会同步更新。

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