如何实现@Scheduled未配置refresh.interval时不启动且不报错？

云原生阿岚

2026-6-13

问题分析

报错的核心原因是：@Scheduled注解的属性会在Spring初始化调度器阶段就被解析，这个时机早于类中@Value字段的赋值逻辑。即使你给@Value设置了null默认值，@Scheduled里的${refresh.interval}占位符在未配置时依然无法被解析，直接触发异常。

解决方案

以下是两种可行的实现方式，推荐第一种更简洁的方案：

方案一：用`@ConditionalOnProperty`控制Bean加载（推荐）

通过条件注解，让Scheduler Bean仅在配置了refresh.interval时才被Spring容器初始化，未配置时Bean不加载，自然不会启动调度任务。

修改后的代码：

@Component
@ConditionalOnProperty(name = "refresh.interval", matchIfMissing = false)
public class Scheduler {

    @Scheduled(fixedRateString = "${refresh.interval}")
    public void refresh() {
        Cache.refresh();
    }
}

@ConditionalOnProperty的matchIfMissing = false表示：只有当refresh.interval存在于配置中时，才创建该Bean。
此时@Scheduled的占位符能正常解析，因为Bean加载的前提是属性已配置，同时也不需要额外的空值判断逻辑。

方案二：编程式注册定时任务（灵活控制）

如果需要更复杂的调度逻辑，可以实现SchedulingConfigurer接口，手动控制任务的注册时机，避免注解解析阶段的占位符错误。

修改后的代码：

@Component
public class Scheduler implements SchedulingConfigurer {

    @Value("${refresh.interval:#{null}}")
    private String refreshInterval;

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        if (StringUtils.isNotBlank(refreshInterval)) {
            long interval = Long.parseLong(refreshInterval);
            taskRegistrar.addFixedRateTask(this::refresh, interval);
        }
    }

    public void refresh() {
        Cache.refresh();
    }
}