Resilience4J Retry 的预期行为是什么？

Question

我在 Spring 引导项目中使用 Resilience4J 来调用 REST 客户端，如下所示：

@Retry(name = "customerService")
public Customer getCustomer(String customerNumber) {
    restTemplate.exchange("https://customer-service.net", HttpMethod.GET, ..., customerNumber);
}

使用此配置：

resilience4j.retry:
    instances:
        customerService:
            maxAttempts: 3
            waitDuration: 10s
            retryExceptions:
                - org.springframework.web.client.HttpServerErrorException

我的预期是，如果调用了restTemplate.exchange()，客服回复了HttpServerErrorException，等待10秒后，getCustomer()方法会被调用3次。

然而，事实并非如此。

此方法不再调用，立即抛出异常。

看到示例中包含回退方法，我决定添加它，即使我真的不想调用不同的方法，我只想再次调用我原来的方法。

无论如何，我指定了后备：

@Retry(name = "customerService", fallback = "customerFb")
public Customer getCustomer(String customerNumber) {
    return getCustomer();
}

private Customer customerFb(String customerNumber, HttpServerErrorException ex) {
    log.error("Could not retrieve customer... retrying...");
    return getCustomer();
}

private Customer getCustomer(String customerNumber) {
    return restTemplate.exchange("https://customer-service.net", HttpMethod.GET, ..., customerNumber);
}

现在，我看到正在重试回退方法，但是，每次都会抛出 HttpServerErrorException，这意味着消费者将收到一个异常作为对其调用的响应。

我的问题是：

是否需要实施回退方法才能使重试功能起作用？

和

抛出异常是预期的行为吗？难道我做错了什么？在所有重试尝试完成之前，我不希望此服务的调用方收到异常。

谢谢

Answer 1

问：是否需要实施回退方法才能使重试功能起作用？

回答：不，Fallback是可选在 Resilience4J 重试功能中。

行为 Resilience4J Retry:

启动时，resilience retry 从应用程序加载配置。properties/yml 如果已配置，其他将使用默认值初始化，如前所述 here in the documentation。
当调用@Retry注解的方法时，会被重试监控。
如果属性 resilience4j.retry.instances.<instance name>.retryExceptions 被显式配置，那么只有配置的异常才会被视为失败，并且只有这些失败和其余的失败才会触发重试异常它在没有重试功能的情况下表现正常。
当在 @retry 注释方法下发生预期的异常时，它不会记录有关异常的任何信息，但会根据 maxAttempts 属性配置。 maxAttempts 属性的默认值为 3。在 maxAttempts 之后它抛出异常并且可以在日志中看到。
还有waitDuration、intervalFunction、ignoreExceptions.. e.tc等属性可以显式配置。有关详细信息，请查看文档 link.
要在用 @retry 注释的方法中实际查看异常事件期间发生了什么，启用 RetryRegistry 事件使用者以打印接收到的事件。

RetryRegistry 事件侦听器的示例代码：

package com.resilience.retry.config;

import javax.annotation.PostConstruct;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

import io.github.resilience4j.retry.RetryRegistry;
import lombok.extern.slf4j.Slf4j;

@Component
@Slf4j
public class RetryRegistryEventListener {

    @Autowired
    private RetryRegistry registry;


    @PostConstruct
    public void postConstruct() {
        //registry.retry(<resilience retry instance name>)
        registry.retry("sample-api").getEventPublisher()
                .onRetry(ev -> log.info("#### RetryRegistryEventListener message: {}", ev));
    }
}

example log:

2021-11-01 14:55:12.337  INFO 18176 --- [nio-8080-exec-1] c.r.retry.controller.RetryController     : Sample Api call receieved
2021-11-01 14:55:12.345  INFO 18176 --- [nio-8080-exec-1] c.r.r.config.RetryRegistryEventListener  : #### RetryRegistryEventListener message: 2021-11-01T14:55:12.344325600+05:30[Asia/Calcutta]: Retry 'sample-api', waiting PT10S until attempt '1'. Last attempt failed with exception 'org.springframework.web.client.HttpServerErrorException: 500 INTERNAL_SERVER_ERROR'.
2021-11-01 14:55:12.350  INFO 18176 --- [nio-8080-exec-1] c.r.retry.controller.RetryController     : messsage: 2021-11-01T14:55:12.344325600+05:30[Asia/Calcutta]: Retry 'sample-api', waiting PT10S until attempt '1'. Last attempt failed with exception 'org.springframework.web.client.HttpServerErrorException: 500 INTERNAL_SERVER_ERROR'.
2021-11-01 14:55:22.359  INFO 18176 --- [nio-8080-exec-1] c.r.retry.controller.RetryController     : Sample Api call receieved
2021-11-01 14:55:22.360  INFO 18176 --- [nio-8080-exec-1] c.r.r.config.RetryRegistryEventListener  : #### RetryRegistryEventListener message: 2021-11-01T14:55:22.360672900+05:30[Asia/Calcutta]: Retry 'sample-api', waiting PT10S until attempt '2'. Last attempt failed with exception 'org.springframework.web.client.HttpServerErrorException: 500 INTERNAL_SERVER_ERROR'.
2021-11-01 14:55:22.361  INFO 18176 --- [nio-8080-exec-1] c.r.retry.controller.RetryController     : messsage: 2021-11-01T14:55:22.360672900+05:30[Asia/Calcutta]: Retry 'sample-api', waiting PT10S until attempt '2'. Last attempt failed with exception 'org.springframework.web.client.HttpServerErrorException: 500 INTERNAL_SERVER_ERROR'.

@FerdTurgusen：我相信您的代码中存在一些错误，否则它可以正常工作。根据问题中的给定信息，我无法准确找到问题所在。因此，我创建了一个示例 spring boot with resilience4j example，复制了您的问题并且它对我来说工作正常，因此上传到 Github 供您参考。我建议您添加 RetryRegistryEventListener class 并在事件日志中查找问题，如果仍未解决，请分享事件监听器日志。

Github 参考: sample spring-boot with resilience4j retry project

Resilience4J Retry 的预期行为是什么？

What is the expected behavior of Resilience4J Retry?

java

spring

spring-boot

resilience4j

resilience4j-retry