一個(gè)Spring注解輕松搞定循環(huán)重試功能！

前言

在實(shí)際工作中，重處理是一個(gè)非常常見的場(chǎng)景，比如:

• 發(fā)送消息失敗。
• 調(diào)用遠(yuǎn)程服務(wù)失敗。
• 爭(zhēng)搶鎖失敗。

這些錯(cuò)誤可能是因?yàn)?a target="_blank">網(wǎng)絡(luò)波動(dòng)造成的，等待過后重處理就能成功。通常來說，會(huì)用try/catch，while循環(huán)之類的語法來進(jìn)行重處理，但是這樣的做法缺乏統(tǒng)一性，并且不是很方便，要多寫很多代碼。然而spring-retry卻可以通過注解，在不入侵原有業(yè)務(wù)邏輯代碼的方式下，優(yōu)雅的實(shí)現(xiàn)重處理功能。

基于 Spring Boot + MyBatis Plus + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

• 項(xiàng)目地址：https://github.com/YunaiV/ruoyi-vue-pro
• 視頻教程：https://doc.iocoder.cn/video/

@Retryable是什么？

spring系列的spring-retry是另一個(gè)實(shí)用程序模塊，可以幫助我們以標(biāo)準(zhǔn)方式處理任何特定操作的重試。在spring-retry中，所有配置都是基于簡(jiǎn)單注釋的。

基于 Spring Cloud Alibaba + Gateway + Nacos + RocketMQ + Vue & Element 實(shí)現(xiàn)的后臺(tái)管理系統(tǒng) + 用戶小程序，支持 RBAC 動(dòng)態(tài)權(quán)限、多租戶、數(shù)據(jù)權(quán)限、工作流、三方登錄、支付、短信、商城等功能

• 項(xiàng)目地址：https://github.com/YunaiV/yudao-cloud
• 視頻教程：https://doc.iocoder.cn/video/

使用步驟

POM依賴

<dependency>
<groupId>org.springframework.retrygroupId>
<artifactId>spring-retryartifactId>
dependency>

啟用@Retryable

@EnableRetry
@SpringBootApplication
publicclassHelloApplication{

publicstaticvoidmain(String[]args){
SpringApplication.run(HelloApplication.class,args);
}

}

在方法上添加@Retryable

importcom.mail.elegant.service.TestRetryService;
importorg.springframework.retry.annotation.Backoff;
importorg.springframework.retry.annotation.Retryable;
importorg.springframework.stereotype.Service;
importjava.time.LocalTime;

@Service
publicclassTestRetryServiceImplimplementsTestRetryService{

@Override
@Retryable(value=Exception.class,maxAttempts=3,backoff=@Backoff(delay=2000,multiplier=1.5))
publicinttest(intcode)throwsException{
System.out.println("test被調(diào)用,時(shí)間："+LocalTime.now());
if(code==0){
thrownewException("情況不對(duì)頭！");
}
System.out.println("test被調(diào)用,情況對(duì)頭了！");

return200;
}
}

來簡(jiǎn)單解釋一下注解中幾個(gè)參數(shù)的含義：

• value：拋出指定異常才會(huì)重試
• include：和value一樣，默認(rèn)為空，當(dāng)exclude也為空時(shí)，默認(rèn)所有異常
• exclude：指定不處理的異常
• maxAttempts：最大重試次數(shù)，默認(rèn)3次
• backoff：重試等待策略，默認(rèn)使用@Backoff，@Backoff的value默認(rèn)為1000L，我們?cè)O(shè)置為2000L；multiplier（指定延遲倍數(shù)）默認(rèn)為0，表示固定暫停1秒后進(jìn)行重試，如果把multiplier設(shè)置為1.5，則第一次重試為2秒，第二次為3秒，第三次為4.5秒。

當(dāng)重試耗盡時(shí)還是失敗，會(huì)出現(xiàn)什么情況呢？

當(dāng)重試耗盡時(shí)，RetryOperations可以將控制傳遞給另一個(gè)回調(diào)，即RecoveryCallback。Spring-Retry還提供了@Recover注解，用于@Retryable重試失敗后處理方法。如果不需要回調(diào)方法，可以直接不寫回調(diào)方法，那么實(shí)現(xiàn)的效果是，重試次數(shù)完了后，如果還是沒成功沒符合業(yè)務(wù)判斷，就拋出異常。

@Recover

@Recover
publicintrecover(Exceptione,intcode){
System.out.println("回調(diào)方法執(zhí)行?。。。?);
//記日志到數(shù)據(jù)庫或者調(diào)用其余的方法
return400;
}

可以看到傳參里面寫的是 Exception e，這個(gè)是作為回調(diào)的接頭暗號(hào)（重試次數(shù)用完了，還是失敗，我們拋出這個(gè)Exception e通知觸發(fā)這個(gè)回調(diào)方法）。對(duì)于@Recover注解的方法，需要特別注意的是：

• 方法的返回值必須與@Retryable方法一致
• 方法的第一個(gè)參數(shù)，必須是Throwable類型的，建議是與@Retryable配置的異常一致，其他的參數(shù)，需要哪個(gè)參數(shù)，寫進(jìn)去就可以了（@Recover方法中有的）
• 該回調(diào)方法與重試方法寫在同一個(gè)實(shí)現(xiàn)類里面

注意事項(xiàng)

• 由于是基于AOP實(shí)現(xiàn)，所以不支持類里自調(diào)用方法
• 如果重試失敗需要給@Recover注解的方法做后續(xù)處理，那這個(gè)重試的方法不能有返回值，只能是void
• 方法內(nèi)不能使用try catch，只能往外拋異常
• @Recover注解來開啟重試失敗后調(diào)用的方法(注意,需跟重處理方法在同一個(gè)類中)，此注解注釋的方法參數(shù)一定要是@Retryable拋出的異常，否則無法識(shí)別，可以在該方法中進(jìn)行日志處理。

總結(jié)

本篇主要簡(jiǎn)單介紹了Springboot中的Retryable的使用，主要的適用場(chǎng)景和注意事項(xiàng)，當(dāng)需要重試的時(shí)候還是很有用的。

審核編輯 ：李倩