Spring异常重试框架Spring Retry 重试机制应用

Spring异常重试框架Spring Retry 重试机制应用

说明(关键总结)：
1、使用了@Retryable的方法不能在本类被调用，不然重试机制不会生效。也就是要标记为@Service，然后在其它类使用@Autowired注入或者@Bean去实例才能生效。 关键

2、要触发@Recover方法，那么在@Retryable方法上不能有返回值，只能是void才能生效。如果一个类中存在多个@Recover方法，可以去掉该类的Recover方法，如果一个类中只有一个@Recover方法，不影响，否则报如下错误：
public void com.insurdock.service.neworderstatus.impl.TBAlipayOrderStatusHandleService.handleOrderRentAmtRenterPaySuccess(com.event.rabbit.neworder.OrderRenterPaySuccessMq)java.lang.ArrayIndexOutOfBoundsException: -1

3、使用了@Retryable的方法里面不能使用try...catch包裹，要在发放上抛出异常，不然不会触发。
简单来说：在抛出重试的异常不能被捕获，方法体中其他的try-catch没有影响。

4、在重试期间这个方法是同步的，如果使用类似Spring Cloud这种框架的熔断机制时，可以结合重试机制来重试后返回结果。**

5、Spring Retry不只能注入方式去实现，还可以通过API的方式实现，类似熔断处理的机制就基于API方式实现会比较宽松。 **

6. @Async 冲突，有关系，需要去掉。否则报如下错误：
2024-06-28 17:35:56.527 [ThreadPoolTaskExecutor-2] ERROR [,] o.s.a.i.SimpleAsyncUncaughtExceptionHandler#handleUncaughtException [line:38] - Unexpected error occurred invoking async method: public void com.insurdock.service.neworderstatus.impl.TBAlipayOrderStatusHandleService.handleOrderRentAmtRenterPaySuccess(com.event.rabbit.neworder.OrderRenterPaySuccessMq)com.insurdock.exception.BusinessException: 请求远程接口异常

7. 第一点：无需从最高一层的调用链来注解。可以从中间链路注解，可以生效。
基本原则：@Autowrie注入的类 调用的方法（直系），需要加上@Retryable ，而不是在 调用的方法 内部嵌套的子方法上加上 @Retryable
注解@Retryable在具体的实现类上，而不是在接口上面。

#重试接口DEMO
1.jar支持

    compile group: 'org.springframework.retry', name: 'spring-retry', version: '1.2.4.RELEASE'
    compile('org.springframework.boot:spring-boot-starter-aop')
    compile('org.aspectj:aspectjweaver')

2.项目启动类上加上注解： @EnableRetry

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.retry.annotation.EnableRetry;

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

3.控制器

@RestController
public class TestController {
    @Autowired
    private RemoteService remoteService;

    @RequestMapping("/show")
    public String show(){
        try {
            remoteService.call();
        } catch (Exception e) {
            // TODO Auto-generated catch block
            //e.printStackTrace();
        }
        return "Hello World";
    }
}

4.服务层

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.remoting.RemoteAccessException;
import org.springframework.retry.annotation.Backoff;
import org.springframework.retry.annotation.Recover;
import org.springframework.retry.annotation.Retryable;
import org.springframework.stereotype.Service;

import java.time.LocalTime;

@Service
public class RemoteService {
    private final static Logger logger = LoggerFactory.getLogger(RemoteService.class);

    @Retryable(value = { RemoteAccessException.class }, maxAttempts = 3, backoff = @Backoff(delay = 5000, multiplier = 1))
    public void call() throws Exception {
        logger.info(LocalTime.now()+" do something...");
        throw new RemoteAccessException("RPC调用异常");
    }

    @Recover
    public void recover(RemoteAccessException e) {
        logger.info(e.getMessage());
    }
}

@Retryable注解
被注解的方法发生异常时会重试 
	value：指定发生的异常进行重试 
	include：和value一样，默认空，当exclude也为空时，所有异常都重试 
	exclude：指定异常不重试，默认空，当include也为空时，所有异常都重试 
	maxAttemps：重试次数，默认3 
	backoff：重试补偿机制，默认没有
	
@Backoff注解
	delay:指定延迟后重试 
	multiplier:指定延迟的倍数，比如delay=5000l,multiplier=2时，第一次重试为5秒后，第二次为10秒，第三次为20秒  multiplier：乘数
	
@Recover 
	当重试到达指定次数时，被注解的方法将被回调，可以在该方法中进行日志处理。需要注意的是发生的异常和入参类型一致时才会回调。

http://localhost:8080/show
日志打印：

2024-07-01 17:24:50.830 [http-nio-exec-1] INFO  [19612125d2d523f9,19612125d2d523f9] c.a.i.service.RemoteService#call [line:20] - 17:24:50.830 do something...
2024-07-01 17:24:55.831 [http-nio-exec-1] INFO  [19612125d2d523f9,19612125d2d523f9] c.a.i.service.RemoteService#call [line:20] - 17:24:55.831 do something...
2024-07-01 17:25:00.831 [http-nio-exec-1] INFO  [19612125d2d523f9,19612125d2d523f9] c.a.i.service.RemoteService#call [line:20] - 17:25:00.831 do something...
2024-07-01 17:25:00.831 [http-nio-exec-1] INFO  [19612125d2d523f9,19612125d2d523f9] c.a.i.service.RemoteService#recover [line:26] - RPC调用异常