JAVA-定时任务@Scheduled && 解决定时任务执行多次@SchedulerLock 加锁

旧城等待， 2024-04-01 11:59 40阅读 0赞

#### 文章目录 ####

*   *  @Scheduled 定时任务
     *   *  使用方法
         *  Cron表达式
     *  @SchedulerLock 加锁
     *   *  使用步骤
         *   *  1、在pom.xml引入相关依赖
             *  2、在数据库建表shedlock
             *  3、配置类
             *  4、在所需任务函数添加相应注解
         *  线程

记录JAVA项目中利用@Scheduled 配置定时任务，并利用@SchedulerLock加锁解决多实例部署定时任务多次执行的问题。

### @Scheduled 定时任务 ###

@Scheduled 可直接在所需函数上配置使用，超级简单便捷。

#### 使用方法 ####

1.  `@Scheduled(fixedDelay = 1000)`  
    上一个任务结束到下一个任务开始的时间间隔为固定的1秒，任务的执行总是要先等到上一个任务的执行结束后再执行。这里单位为毫秒，所以为1000
2.  `@Scheduled(fixedRate = 1000)`  
    每间隔1秒钟就会执行任务（如果任务执行的时间超过1秒，则下一个任务在上一个任务结束之后立即执行）。
3.  `@Scheduled(fixedDelay = 1000, initialDelay = 2000)`  
    initialDelay第一次执行的任务将会延迟2秒钟后才会启动，
4.  `@Scheduled(cron = “0 * * * * ?”)`  
    Cron表达式，每分钟执行一次

#### Cron表达式 ####

Cron表达式在线工具，类型选择“ Java(Quartz)”：https://tool.lu/crontab/

Cron表达式是一种字符串形式的，字符串以5或6个空格隔开，分为6或7个域，每一个域代表一个含义，Cron有如下两种语法格式：

（1） Seconds Minutes Hours DayofMonth Month DayofWeek Year  
（2）Seconds Minutes Hours DayofMonth Month DayofWeek  
![在这里插入图片描述][06d44cab596d4338abcfdb0b698721d7.png]  
（1）\*：表示匹配该域的任意值。假如在Minutes域使用, 即表示每分钟都会触发事件。

（2）?：只能用在DayofMonth和DayofWeek两个域。它也匹配域的任意值，但实际不会。因为DayofMonth和DayofWeek会相互影响。例如想在每月的20日触发调度，不管20日到底是星期几，则只能使用如下写法： 13 13 15 20 ?, 其中最后一位只能用？，而不能使用，如果使用\*表示不管星期几都会触发，实际上并不是这样。

（3）-：表示范围。例如在Minutes域使用5-20，表示从5分到20分钟每分钟触发一次

（4）/：表示起始时间开始触发，然后每隔固定时间触发一次。例如在Minutes域使用5/20,则意味着5分钟触发一次，而25，45等分别触发一次.

（5）,：表示列出枚举值。例如：在Minutes域使用5,20，则意味着在5和20分每分钟触发一次。

（6）L：表示最后，只能出现在DayofWeek和DayofMonth域。如果在DayofWeek域使用5L,意味着在最后的一个星期四触发。

（7）W:表示有效工作日(周一到周五),只能出现在DayofMonth域，系统将在离指定日期的最近的有效工作日触发事件。例如：在 DayofMonth使用5W，如果5日是星期六，则将在最近的工作日：星期五，即4日触发。如果5日是星期天，则在6日(周一)触发；如果5日在星期一到星期五中的一天，则就在5日触发。另外一点，W的最近寻找不会跨过月份 。

（8）LW:这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。

（9）\#:用于确定每个月第几个星期几，只能出现在DayofMonth域。例如在4\#2，表示某月的第二个星期三。

**Cron表达式范例：**  
每隔5秒执行一次：/5 \* ?  
每隔1分钟执行一次：0 /1 ?  
每天23点执行一次：0 0 23 ?  
每天凌晨1点执行一次：0 0 1 ?  
每月1号凌晨1点执行一次：0 0 1 1 \* ?  
每月最后一天23点执行一次：0 0 23 L \* ?  
每周星期天凌晨1点实行一次：0 0 1 ? \* L

### @SchedulerLock 加锁 ###

遇到了在起多实例的情况会造成定时任务的多次执行，可以使用锁来解决该问题@SchedulerLock

shedlock提供了mongo、redis、zookeeper、jdbc等的锁实现，这里使用jdbc。

#### 使用步骤 ####

##### 1、在pom.xml引入相关依赖 #####

<dependency>
    			<groupId>net.javacrumbs.shedlock</groupId>
    			<artifactId>shedlock-spring</artifactId>
    			<version>4.42.0</version>
    		</dependency>
    
    		<dependency>
    			<groupId>net.javacrumbs.shedlock</groupId>
    			<artifactId>shedlock-provider-jdbc-template</artifactId>
    			<version>4.42.0</version>
    		</dependency>

##### 2、在数据库建表shedlock #####

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

@SchedulerLock声明的锁名称自动创建对应的键值对，提供锁。  
`@SchedulerLock(name = “xx”）`name值对应的是库里的name的赋值。  
定时任务执行会在shedlock表里有锁的信息，如果该表为空则表示配置未生效，需检查自己的配置了

> 属性说明:  
> name 锁名称 ，name必须是主键  
> lock\_until 释放锁时间  
> locked\_at 获取锁时间  
> locked\_by 锁提供者

##### 3、配置类 #####

package com.xx.config;
    
    import net.javacrumbs.shedlock.core.LockProvider;
    import net.javacrumbs.shedlock.provider.jdbctemplate.JdbcTemplateLockProvider;
    import net.javacrumbs.shedlock.spring.annotation.EnableSchedulerLock;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import org.springframework.jdbc.core.JdbcTemplate;
    import org.springframework.scheduling.annotation.EnableScheduling;
    
    import javax.sql.DataSource;
    import java.time.Duration;
    
    @Configuration
    @EnableScheduling
    @EnableSchedulerLock(defaultLockAtMostFor = "10m")
    public class ShedlockConfig {
        
        @Bean
        public LockProvider lockProvider(DataSource dataSource) {
        
            return new JdbcTemplateLockProvider(
                    JdbcTemplateLockProvider.Configuration.builder()
                            .withJdbcTemplate(new JdbcTemplate(dataSource))
                            .usingDbTime() // Works on Postgres, MySQL, MariaDb, MS SQL, Oracle, DB2, HSQL and H2
                            .build()
            );
        }
    }

##### 4、在所需任务函数添加相应注解 #####

例如: 这儿配置每10分钟执行一次，该锁将持有5分钟，5分钟后释放; 当节点异常或者死亡，该锁默认在15分钟后自动释放。  
在正常情况下，ShedLock在任务完成后立即释放锁定。@EnableSchedulerLock中也提供了默认值， 我们也可以直接只填写name即可,在这配置了的话会覆盖默认配置

@Scheduled(cron = "0 0 * * * ?")
        @SchedulerLock(name = "test",
                lockAtMostFor = 15 * 60 * 1000, lockAtLeastFor = 5 * 60 * 1000)
        public void test(){
        
            log.info(String.format("EXECUTE:%s",true));
        }

lockAtMostFor 单位 毫秒  
lockAtMostForString 使用“ PT14M” 意味着它将被锁定不超过14分钟。

lockAtLeastFor 单位 毫秒  
lockAtLeastForString 使用“ PT14M” 或"PT30S”

> 注解参数说明：  
> ● name: 锁名称,锁名称必须是唯一的,同时在一个时间内只能执行一个任务。  
> ● lockAtMostFor: 指定在执行节点死亡时应将锁保留多长时间。这只是一个备用选项，在正常情况下，任务完成后立即释放锁定。 使用时必须将其设置lockAtMostFor为比正常执行时间长得多的值。如果任务花费的时间超过 lockAtMostFor了所导致的行为，则可能无法预测（更多的进程将有效地持有该锁）。  
> ● lockAtLeastFor: 保留锁的最短时间，防止如果定时的执行时间短，不同节点之间的服务器时间存在差异，导致定时重复执行

#### 线程 ####

scheduled默认是所有定时任务都在一个线程中执行。也就是说定时任务1一直在执行，定时任务2一直在等待定时任务1执行完成。为了避免相互等待的情况，可以为定时任务配置线程池

@Configuration
    public class ScheduleConfig implements SchedulingConfigurer {
        
        @Override
        public void configureTasks(ScheduledTaskRegistrar taskRegistrar) {
        
            taskRegistrar.setScheduler(Executors.newScheduledThreadPool(50));
        }
    }

在程序启动后，会逐步启动50个线程，放在线程池中。每个定时任务会占用1个线程。但是相同的定时任务，执行的时候，还是在同一个线程中。

也可配置异步执行，相同的任务也不会相互影响。

配置类

@Configuration
    @EnableAsync
    public class ScheduleConfig {
        
        @Bean
        public TaskScheduler taskScheduler() {
        
            ThreadPoolTaskScheduler taskScheduler = new ThreadPoolTaskScheduler();
            taskScheduler.setPoolSize(50);
            return taskScheduler;
        }
    }

在方法上添加注解@Async 即可, 同一个定时任务也会启动多个线程处理

@Async
    	@Scheduled(cron = "0 0 * * * ?")
        @SchedulerLock(name = "test",
                lockAtMostFor = 15 * 60 * 1000, lockAtLeastFor = 5 * 60 * 1000)
        public void test(){
        
            log.info(String.format("EXECUTE:%s",true));
        }

参考：https://github.com/lukas-krecan/ShedLock  
https://blog.csdn.net/reinsunshine/article/details/126094351

[06d44cab596d4338abcfdb0b698721d7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/01/399423d4d8d84f739641ac5f8c5c6ed5.png