如何在OpenLiberty中测试@Retry与@Fallback注解（TestContainers场景）

我的服务类中有如下发送邮件的方法：当邮件客户端抛出RuntimeException时，会重试4次调用邮件客户端发送邮件；若4次重试均失败，则执行sendEmailFallback降级方法。

@Retry(maxRetries = 4, delay = 1000, jitter = 200, retryOn = RuntimeException.class)
@Fallback(fallbackMethod = "sendEmailFallback")
public String sendEmailNow(EmailData data) {
    client.sendEmail(data);
    return "Email sent successfully!";
}

public String sendEmailFallback(EmailData data) {
    LOGGER.error("Failed to send email after retries. Executing fallback method.");
    return "Failed to send email after retries. Executing fallback method.";
}

目前我使用TestContainers进行端到端测试，启动OpenLiberty容器后无法修改配置模拟错误场景，且不想创建第二个容器，请问该如何测试上述注解功能？

可行的测试方案 #

1. 替换邮件客户端为Mock实现 #

不需要修改容器配置，直接在测试阶段替换真实邮件客户端，用主动抛异常的Mock触发重试和降级逻辑：

• 若用CDI依赖注入，在测试类中创建@Alternative注解的邮件客户端实现，其sendEmail方法直接抛出RuntimeException。
• 或用Mockito等工具，通过OpenLiberty的@MockBean测试扩展替换容器内的客户端实例。
• 测试时调用sendEmailNow，需断言：
  • Mock的sendEmail方法被调用5次（初始调用+4次重试）
  • 方法返回值与sendEmailFallback的返回值一致
  • 日志中输出了降级方法的错误信息

2. 通过MicroProfile Config动态触发错误场景 #

在真实邮件客户端中添加配置开关，控制是否抛出异常：

@Inject
Config config;

public void sendEmail(EmailData data) {
    if (Boolean.parseBoolean(config.getValue("email.client.simulate-failure", String.class))) {
        throw new RuntimeException("Simulated email send failure");
    }
    // 真实发送逻辑
}

启动TestContainers的OpenLiberty容器时，通过环境变量注入该配置：

@Testcontainers
public class EmailServiceTest {
    @Container
    public static OpenLibertyContainer liberty = new OpenLibertyContainer()
            .withEnv("MICROPROFILE_CONFIG_PROPERTIES", "email.client.simulate-failure=true");
    
    // 测试逻辑
}

若需在同一测试类中切换场景：

• 利用MicroProfile Config的动态更新特性，通过REST端点或配置客户端在测试中修改配置值
• 或在不同测试方法中复用容器配置，修改环境变量后重新启动容器

3. 利用OpenLiberty测试扩展控制依赖行为 #

OpenLiberty提供@MockitoExtension等扩展，可在集成测试中直接Mock容器内的依赖：

@RunWith(LibertyTestRunner.class)
@MockitoExtension
public class EmailServiceTest {
    @Inject
    EmailService emailService;
    
    @Mock
    EmailClient client;
    
    @Test
    public void testRetryAndFallback() {
        // 配置Mock每次调用都抛出异常
        doThrow(new RuntimeException()).when(client).sendEmail(any(EmailData.class));
        
        String result = emailService.sendEmailNow(new EmailData());
        
        // 验证重试次数
        verify(client, times(5)).sendEmail(any(EmailData.class));
        // 验证返回值
        assertEquals("Failed to send email after retries. Executing fallback method.", result);
    }
}

这种方式无需修改容器配置，直接在测试层控制依赖行为，适合验证注解逻辑。

内容的提问来源于stack exchange，提问作者Alex_Pap