添加@RefreshScope后@Scheduled定时任务在Consul配置更新时停止运行

这个问题我之前也碰到过，本质是**@RefreshScope的实例替换机制和Spring任务调度器的工作逻辑冲突**导致的，我来给你拆解原因和可行的解决方案：

问题根源 #

当你给MonitorService加上@RefreshScope后，每次Consul配置刷新时，Spring会创建一个全新的MonitorService实例替换掉旧的。但Spring的@Scheduled定时任务是绑定在原始实例上的——旧实例被销毁后，原来的定时任务也会跟着终止，而新生成的实例并不会自动向调度器注册这个定时任务，所以你就看不到后续的打印输出了。

最优解决方案：将@RefreshScope移至配置类 #

既然你需要刷新的只是配置参数，完全没必要让定时任务所在的服务类进入刷新范围，把@RefreshScope加到AppConfig上就够了：

修改后的MonitorService #

@Service
public class MonitorService { 
    @Autowired 
    private AppConfig appConfig; 

    @PostConstruct 
    public void postConstRun() { 
        System.out.println(appConfig.getMonitorConfig()); 
    } 

    @Scheduled(fixedRate = 1000) 
    public void scheduledMonitorScan() { 
        System.out.println("MonitorConfig:" + appConfig.getMonitorConfig()); 
    } 
}

修改后的AppConfig #

@Configuration 
@Getter 
@Setter
@RefreshScope // 仅给配置类添加刷新注解
public class AppConfig { 
    @Value("${monitor-config:default value}") 
    private String monitorConfig; 
}

这样配置刷新时，只有AppConfig的实例会被更新，MonitorService的实例保持不变，定时任务会持续运行，而且每次执行时都能拿到最新的配置值。

特殊场景：必须给MonitorService加@RefreshScope的情况 #

如果你的MonitorService本身有其他需要随配置刷新的逻辑（比如依赖其他带刷新注解的bean），可以通过监听刷新事件手动重新注册定时任务：

@Service 
@RefreshScope 
public class MonitorService implements ApplicationListener<RefreshScopeRefreshedEvent> { 
    @Autowired 
    private AppConfig appConfig; 
    @Autowired 
    private TaskScheduler taskScheduler;
    private ScheduledFuture<?> scheduledTask;

    @PostConstruct 
    public void postConstRun() { 
        System.out.println(appConfig.getMonitorConfig()); 
        startScheduledTask(); // 初始化时启动任务
    } 

    private void startScheduledTask() {
        // 先取消旧任务（如果存在）
        if (scheduledTask != null && !scheduledTask.isCancelled()) {
            scheduledTask.cancel(false);
        }
        // 注册新的定时任务
        scheduledTask = taskScheduler.scheduleAtFixedRate(
            this::scheduledMonitorScan, 
            Duration.ofSeconds(1)
        );
    }

    public void scheduledMonitorScan() { 
        System.out.println("MonitorConfig:" + appConfig.getMonitorConfig()); 
    }

    @Override
    public void onApplicationEvent(RefreshScopeRefreshedEvent event) {
        // 配置刷新后，重新启动定时任务
        startScheduledTask();
    }
}

注意：这种方式需要移除原来的@Scheduled注解，改用TaskScheduler手动管理任务生命周期，确保每次刷新后新的bean实例能重新注册任务。

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