spring boot项目中处理Schedule定时任务

小鱼儿 2022-05-15 15:18 243阅读 0赞

项目中，因为使用了第三方支付（支付宝和微信支付），支付完毕后，第三方支付平台一般会采用异步回调通知的方式，通知商户支付结果，然后商户根据通知内容，变更商户项目支付订单的状态。一般来说，为了防止商户项目自身因为一些特殊原因，比如正好当时网络状态不稳定，商户回调接口无法访问，或者商户回调接口出现异常。第三方支付平台，一般会发送多次请求来尽量确保通知到商户系统。

但是，总会有各种各样的情况，导致，第三方平台所有的通知次数通知完毕后，商户系统依然没有正确处理掉改笔订单状态。（一般第三方支付平台，会：1分钟，10分钟，1小时，6小时，12小时，24小时通知商户支付接口，当然这个时间只是举例而已，实际的通知时间会和这个不太一样，但是也是大致的意思）。当如果按这个频次通知完毕后，第三方支付平台就不再进行通知了。

所以，一旦第三方支付平台，将通知次数发送完毕后，平台依然没有处理好自己项目的订单状态，那么订单状态很可能是，客户实际已经完成支付，但是自己项目这边依然显示：“等待支付”这样的状态。那么为了解决这类问题，一般，我们会采用定时任务的方式，比如1个小时，我们把订单支付已经超过1小时，但是还没超过24小时的订单去第三方平台主动的查询一次订单状态。避免因为自己原因，导致的订单状态不一致的情况。这类设置已经超过1小时，未超过24小时的原因，主要是为了查询效率，因为半小时之内还未支付，我们认为实际中存在这个可能性，所以可以等到1个小时，在查状态，而不超过24小时的原因是，一旦超过24小时，我们可以认为订单实际上已经超时失败了，如果查这个订单，就会导致，每次定时任务都会把之前已经查过的订单，在反复的查询。造成大量不必要的查询。一般我们也会在启一个定时任务，24小时执行一次，把一些订单重置为失败。减少不必要的失败订单的反复查询。

下面进入正题，在spring boot中，如何来处理定时任务。  
默认，springboot已经支持了定时任务Schedule模块，所以一般情况已经完全能够满足我们的实际需求，一般来说，没有必要在加入其他类似于：quartz

另外，在这里提一个实际项目中，关于定时任务的架构上的一些考虑：

一般来说，实际项目中，为了提高服务的响应能力，我们一般会通过负载均衡的方式，或者反向代理多个节点的方式来进行。通俗点来说，我们一般会将项目部署多实例，或者说部署多份，每个实例不同的启动端口。但是每个实例的代码其实都是一样的。如果我们将定时任务写在我们的项目中，就会面临一个麻烦，就是比如我们部署了3个实例，三个实例一启动，就会把定时任务都启动，那么在同一个时间点，定时任务会一起执行，也就是会执行3次，这样很可能会导致我们的业务出现错误。

一般来说，我们有几种简单的办法来处理：

1、配置文件中增加自定义配置，通过开关来进行控制：比如增加：schedule=enable , schedule=disable，这样在我们的实际代码中，在进行判断，也就是我们可以通过配置，达到，只有一个实例真正执行定时任务，其他的是实例不执行。但是，这种做法实际是还是定时任务都启动，只是在执行中，我们人工来进行判断，执行于不执行真正的处理逻辑。  
2、逻辑分离，就是我们将真正要定时任务处理的逻辑，写成rest服务，或者rpc服务，然后我们可以新建一个单独的定时任务项目，这个项目应该是没有任何的业务代码的，他纯粹只有定时任务功能，几点启动，或者每隔多少时间启动，启动后，通过rest或者rpc的方式，调用真正处理逻辑的服务。同时，我们甚至可以不用新建一个项目，我们通过linux的cron就可以进行。同时，这种方式还有一个好处，比如有些时候，我们的定时任务也会因为某些原因出现问题，没有执行，那么我们就可以通过curl 或者wget等等很多方式，再次定时任务的执行。

所以，个人一般偏向使用第二种方式，达到定时任务和业务处理的分离。

而在spring boot中，如何使用定时任务，相对比较简单。按第二种方式，实际上，我需要新建一个项目来完成定时任务的功能，其实，我们完全可以新建一个普通的java项目，引入quartz来达到，但是这里，我是通过spring boot来完成，新建一个spring boot项目，项目的初始化可以使用：[http://start.spring.io][http_start.spring.io]

初始化之后，我们在spring boot的入口类Application.java中，允许支持schedule

@SpringBootApplication
    @EnableScheduling
    public class Application {
        public static void main(String[] args) {
            SpringApplication.run(Application.class, args);
        }
    }

然后，新建一个执行类Jobs.java

@Component
    public class Jobs {
        public final static long ONE_Minute =  60 * 1000;
        
        @Scheduled(fixedDelay=ONE_Minute)
        public void fixedDelayJob(){
            System.out.println(Dates.format_yyyyMMddHHmmss(new Date())+" >>fixedDelay执行....");
        }
        
        @Scheduled(fixedRate=ONE_Minute)
        public void fixedRateJob(){
            System.out.println(Dates.format_yyyyMMddHHmmss(new Date())+" >>fixedRate执行....");
        }
    
        @Scheduled(cron="0 15 3 * * ?")
        public void cronJob(){
            System.out.println(Dates.format_yyyyMMddHHmmss(new Date())+" >>cron执行....");
        }
    }

这是最简单的2种方式，多少分钟执行一次，fixedDelay和fixedRate，单位是毫秒，所以1分钟就是60秒×1000  
他们的区别在于，fixedRate就是每多次分钟一次，不论你业务执行花费了多少时间。我都是1分钟执行1次，而fixedDelay是当任务执行完毕后1分钟在执行。所以根据实际业务不同，我们会选择不同的方式。

而还有一类定时任务，比如是每天的3点15分执行，那么我们就需要用另外一种方式：cron表达式

cron表达式，有专门的语法，而且感觉有点绕人，不过简单来说，大家记住一些常用的用法即可，特殊的语法可以单独去查。  
cron一共有7位，但是最后一位是年，可以留空，所以我们可以写6位：

* 第一位，表示秒，取值0-59
    * 第二位，表示分，取值0-59
    * 第三位，表示小时，取值0-23
    * 第四位，日期天/日，取值1-31
    * 第五位，日期月份，取值1-12
    * 第六位，星期，取值1-7，星期一，星期二...，注：不是第1周，第二周的意思
              另外：1表示星期天，2表示星期一。
    * 第7为，年份，可以留空，取值1970-2099

cron中，还有一些特殊的符号，含义如下：

(*)星号：可以理解为每的意思，每秒，每分，每天，每月，每年...
    (?)问号：问号只能出现在日期和星期这两个位置，表示这个位置的值不确定，每天3点执行，所以第六位星期的位置，我们是不需要关注的，就是不确定的值。同时：日期和星期是两个相互排斥的元素，通过问号来表明不指定值。比如，1月10日，比如是星期1，如果在星期的位置是另指定星期二，就前后冲突矛盾了。
    (-)减号：表达一个范围，如在小时字段中使用“10-12”，则表示从10到12点，即10,11,12
    (,)逗号：表达一个列表值，如在星期字段中使用“1,2,4”，则表示星期一，星期二，星期四
    (/)斜杠：如：x/y，x是开始值，y是步长，比如在第一位（秒） 0/15就是，从0秒开始，每15秒，最后就是0，15，30，45，60    另：*/y，等同于0/y

下面列举几个例子供大家来验证：

0 0 3 * * ?     每天3点执行
    0 5 3 * * ?     每天3点5分执行
    0 5 3 ? * *     每天3点5分执行，与上面作用相同
    0 5/10 3 * * ?  每天3点的 5分，15分，25分，35分，45分，55分这几个时间点执行
    0 10 3 ? * 1    每周星期天，3点10分 执行，注：1表示星期天    
    0 10 3 ? * 1#3  每个月的第三个星期，星期天 执行，#号只能出现在星期的位置

**©声明：**除非注明，本站所有文章皆为原创，转载请以链接形式标明本文地址。  
**©转载请注明来源：**[https://www.rjkf.cn/springboot-schedule-cron/][https_www.rjkf.cn_springboot-schedule-cron]

[http_start.spring.io]: https://link.jianshu.com?t=http://start.spring.io
[https_www.rjkf.cn_springboot-schedule-cron]: https://link.jianshu.com?t=https://www.rjkf.cn/springboot-schedule-cron/