SpringBoot定时任务 @Scheduled详解

「爱情、让人受尽委屈。」 2024-03-24 14:22 116阅读 0赞

#### SpringBoot定时任务 ####

*   *   *  一.@Scheduled注解参数
         *   *  1.cron参数
         *  cron参数意义：
         *  常用通配符：
         *   *  2.zone参数
             *  3.fixedDelay
             *  4.fixedDelayString
             *  5.fixedRate
             *  6.fixedRateString
             *  7.initialDelay
             *  8.initialDelayString
         *  二.注意

博主在最近的开发中又遇到了关于定时调度的开发任务，在定时调度其实有很多的第三方平台可以接入，但是其实在SpringBoot有自带的定时任务注解@Scheduled。@Scheduled可以通过注解配置快速实现方法的定时调度，直接在方法加上@Scheduled注解即可。

#### 一.@Scheduled注解参数 ####

##### 1.cron参数 #####

这个参数是最经常使用的参数，表示接收一个cron参数，cron它是一个表达式，最多接收7个参数，从左到右分别表示：秒 分 时 天 月 周 年；参数以空格隔开，其中年不是必须参数，可以省略。

/**
    * cron 一共可以有7个参数 以空格分开 其中年不是必须参数
    * [秒] [分] [小时] [日] [月] [周] [年]
    * 一下表示
    */
    @Scheduled(cron ="0 0 0 * * * ?")
    public void testScheduledCron(){
        
    }

注意！！！ 在使用时需要在类上添加注解@EnableScheduling，表示开启定时任务。

#### cron参数意义： ####

<table> 
 <thead> 
  <tr> 
   <th>序号</th> 
   <th>含义</th> 
   <th>是否必填</th> 
   <th>入参范围</th> 
   <th>可填通配符</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>1</td> 
   <td>秒</td> 
   <td></td> 
   <td>是</td> 
   <td>0-59</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td>分</td> 
   <td></td> 
   <td>是</td> 
   <td>0-59</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td>时</td> 
   <td></td> 
   <td>是</td> 
   <td>0-23</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td>日</td> 
   <td></td> 
   <td>是</td> 
   <td>1-31</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td>月</td> 
   <td></td> 
   <td>是</td> 
   <td>1-12</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td>周（周一 ~ 周日） 是</td> 
   <td>1-7</td> 
   <td>, - * ? / L #</td> 
   <td></td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td>年</td> 
   <td>否</td> 
   <td>1970-2099</td> 
   <td>, - * /</td> 
  </tr> 
 </tbody> 
</table>

#### 常用通配符： ####

*  \*：表示所有值 比如用在日 表示每一天。
 *  ?：表示不指定值 比如周配置 表示不指定星期几执行。
 *  /：表示递增触发 比如 用在分 5/20 从第五分钟开始 每增加20分钟执行一次。
 *  \-：表示区间 比如用在 1-6 表示一月到六月执行。

**示例：**  
每天凌晨零点执行

@Scheduled(cron ="0 0 0 * * * ?")

每隔五分钟执行

@Scheduled(cron ="0 */5 0 * * * ?")

##### 2.zone参数 #####

zone能够指定获取的时区，默认是空，表示使用服务器所在时区，比如Asia/BeiJingi或者Asia/Shanghai。

##### 3.fixedDelay #####

fixedDelay表示上次调用结束后与下次调用之间的固定时间，单位是毫秒。

@Scheduled(fixedDelay= 3000)

表示距离上次调用后三秒再执行

##### 4.fixedDelayString #####

fixedDelayString与fixedDelay是几乎一样的，唯一的差异是fixedDelayString是支持占位符的。

##### 5.fixedRate #####

fixedRate表示多久执行一次，单位是毫秒。与cron的/通配符用法相似；

@Scheduled(fixedRate= 3000)

**表示每三秒执行一次**

##### 6.fixedRateString #####

fixedRate的升级，支持占位符

##### 7.initialDelay #####

表示第一次延迟多少毫秒执行，单位是毫秒

@Scheduled(initialDelay= 3000)

表示第一次执行时，延迟3秒执行

##### 8.initialDelayString #####

initialDelay的升级，支持占位符。

#### 二.注意 ####

@Scheduled使用时，是在本机进行任务调度，但是目前几乎所有的应用为了增加发负载量，都是使用多机部署。这就导致了一个非常严重的分布式问题：在每一台机器上都会在同时执行定时调度任务，可能产生很多重复数据或者导致系统出现其他的业务逻辑BUG，所以在使用@Scheduled进行任务调度时，一定要配合redis的分布式锁来使用，让定时调度任务只在一台机器上执行，避免BUG出现。同时对于可能出现的失败任务一定要做好日志记录，方便排查和改错哟~

如有帮助请点赞支持~ 感谢阅读~