Spring Boot：从配置文件配置@Scheduled的cron表达式，规避常量值报错

核心原因 #

你遇到的「Attribute value must be constant」错误，是因为Java注解参数要求是编译期常量，直接引用配置文件加载的变量不符合这个限制。借助Spring表达式语言（SpEL），可以让注解在运行时动态读取配置值，绕过这个问题。

最简解决方案 #

直接在@Scheduled注解中用SpEL语法引用配置文件属性：

1. 修改定时任务代码 #

import net.javacrumbs.shedlock.spring.annotation.SchedulerLock;
import org.springframework.scheduling.annotation.Scheduled;
import org.springframework.stereotype.Component;

@Component
public class CleanupTask {

    @Scheduled(cron = "${task.cleanup.cron}")
    @SchedulerLock(
        name = "cleanupScheduleLock",
        lockAtMostFor = "${task.cleanup.lock-at-most}", // 锁时长也支持动态配置
        lockAtLeastFor = "${task.cleanup.lock-at-least}"
    )
    public void runCleanupSchedule() throws IOException {
        // 你的任务逻辑代码
    }
}

2. 在配置文件中定义Cron规则 #

根据不同环境创建对应配置文件，示例如下：

开发环境（application-dev.properties）

# 每3小时执行一次
task.cleanup.cron=0 0 */3 * * *
# 锁最长持有1小时，最短持有30分钟
task.cleanup.lock-at-most=PT1H
task.cleanup.lock-at-least=PT30M

生产环境（application-prod.properties）

# 每6小时执行一次
task.cleanup.cron=0 0 */6 * * *
# 锁最长持有2小时，最短持有1小时
task.cleanup.lock-at-most=PT2H
task.cleanup.lock-at-least=PT1H

3. 激活对应环境 #

启动应用时通过参数指定环境：

java -jar your-app.jar --spring.profiles.active=prod

进阶方案（运行时动态修改Cron） #

如果需要在应用运行时动态调整定时规则，可以通过ScheduledTaskRegistrar手动注册任务，结合配置监听实现动态更新：

import net.javacrumbs.shedlock.core.LockProvider;
import net.javacrumbs.shedlock.spring.annotation.SchedulerLock;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.Trigger;
import org.springframework.scheduling.TriggerContext;
import org.springframework.scheduling.annotation.SchedulingConfigurer;
import org.springframework.scheduling.config.ScheduledTaskRegistrar;
import org.springframework.scheduling.support.CronTrigger;

import java.util.Date;

@Configuration
public class DynamicCleanupTask implements SchedulingConfigurer {

    @Value("${task.cleanup.cron}")
    private String cronExpression;

    private final LockProvider lockProvider;

    public DynamicCleanupTask(LockProvider lockProvider) {
        this.lockProvider = lockProvider;
    }

    @Override
    public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        taskRegistrar.addTriggerTask(
            () -> runCleanupSchedule(),
            triggerContext -> {
                // 此处可扩展逻辑，比如从数据库实时读取最新Cron表达式
                CronTrigger trigger = new CronTrigger(cronExpression);
                return trigger.nextExecutionTime(triggerContext);
            }
        );
    }

    @SchedulerLock(name = "cleanupScheduleLock", lockAtMostFor = "PT1H")
    public void runCleanupSchedule() throws IOException {
        // 任务逻辑
    }
}

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