Shedlock能否用于非Spring Boot应用？配置问题求助

Shedlock完全支持非Spring Boot的Spring应用，不用找替代方案，你的问题大概率是手动配置不到位导致锁记录未写入数据库。下面是针对性的配置步骤和排查要点：

核心配置步骤（无application.yml场景） #

因为没有Spring Boot的自动配置，必须手动通过Java配置类定义Shedlock所需的核心Bean：

1. 编写Shedlock配置类 #

@Configuration
@EnableScheduling // 开启Spring定时任务
@EnableSchedulerLock(defaultLockAtMostFor = "PT30S") // 全局默认锁最长持有时间
public class ShedlockConfig {

    // 配置数据源（如果已有现成数据源，直接注入即可，无需重复定义）
    @Bean
    public DataSource dataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");
        dataSource.setUrl("jdbc:mysql://localhost:3306/your_db");
        dataSource.setUsername("db_user");
        dataSource.setPassword("db_pwd");
        return dataSource;
    }

    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }

    // 配置数据库锁提供者
    @Bean
    public LockProvider lockProvider(JdbcTemplate jdbcTemplate) {
        // 若自定义了锁表名，可通过JdbcLockProviderBuilder指定：.withTableName("your_custom_lock_table")
        return new JdbcLockProvider(jdbcTemplate);
    }

    // 构建Shedlock调度配置
    @Bean
    public SchedulerLockConfiguration schedulerLockConfiguration(LockProvider lockProvider) {
        return SchedulerLockConfigurationBuilder
                .withLockProvider(lockProvider)
                .build();
    }
}

2. 确保定时任务注解配置正确 #

在你的任务方法上必须同时标注@Scheduled和@SchedulerLock，且锁名称要唯一：

@Component
public class ExclusiveTask {

    @Scheduled(fixedRate = 60000) // 定时任务触发规则
    @SchedulerLock(
        name = "unique_task_lock_name", // 锁名称，对应数据库表的name字段
        lockAtMostFor = "PT20S", // 该任务锁最长持有时间
        lockAtLeastFor = "PT5S" // 该任务锁最短持有时间
    )
    public void runSingleInstanceTask() {
        // 你的业务逻辑代码
    }
}

关键排查要点 #

1. 验证数据库表结构
   确保你创建的锁表结构符合要求（以MySQL为例）：

CREATE TABLE shedlock(
    name VARCHAR(64) NOT NULL,
    lock_until TIMESTAMP(3) NOT NULL,
    locked_at TIMESTAMP(3) NOT NULL,
    locked_by VARCHAR(255) NOT NULL,
    PRIMARY KEY (name)
) ENGINE=InnoDB;

如果用其他数据库，需对应调整字段类型（比如PostgreSQL用TIMESTAMP WITH TIME ZONE）。

2. 检查Spring上下文扫描范围
   确保@ComponentScan注解覆盖了配置类、任务类所在的包，否则这些Bean不会被加载。

3. 验证数据源权限
   确认数据库用户拥有shedlock表的增、删、改、查权限，否则Shedlock无法写入锁记录。

4. 开启日志排查
   将net.javacrumbs.shedlock包的日志级别设为DEBUG，可以查看锁获取、释放的详细过程，定位具体失败原因。

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