Spring RetryTemplate恢复块日志在单元测试中无法显示的原因

1. 恢复块未被触发 #

RecoveryCallback只有在重试次数耗尽后才会执行，并非每次重试失败就触发。如果单元测试中触发的异常次数未达到RetryTemplate配置的最大重试次数，恢复块根本不会执行，自然没有日志输出。

• 验证方式：检查RetryTemplate的重试策略配置，比如SimpleRetryPolicy的maxAttempts值。假设maxAttempts=3，需要让测试中的操作连续失败3次，才会进入恢复块。
• 测试示例：在单元测试中模拟连续抛出异常，直到重试次数耗尽。

2. 日志配置未正确加载 #

虽然你在application-test.properties中设置了logging.level.com.myproject.service=DEBUG，但可能存在配置未生效的情况：

• 确认@TestPropertySource的路径是否正确，比如classpath:application-test.properties文件是否存在、路径拼写无误。
• 在测试类中注入Environment，打印logging.level.com.myproject.service的值，验证配置是否被加载。
• 临时在测试类中添加一条log.debug("测试日志输出")，确认日志框架本身能正常输出日志。

3. 日志对象的类路径与配置不匹配 #

如果log对象所属的类不在com.myproject.service包（或其子包）下，或者存在其他日志配置覆盖了当前设置，可能导致日志无法输出：

• 检查log所在类的包名，确保和配置的logging.level路径匹配。如果类在com.myproject.service.impl下，默认会继承父包的日志级别，但如果有其他配置（比如单独给子包设置了更高级别）会覆盖。
• 临时将logging.level.root=DEBUG添加到测试配置中，看是否能输出恢复块的日志，排除路径匹配问题。

4. 测试环境RetryTemplate配置异常 #

测试环境中的RetryTemplate可能和生产环境配置不一致，导致恢复块未被正确绑定：

• 在单元测试中注入RetryTemplate，打印其recoveryCallback和retryPolicy的配置，确认恢复回调已正确设置，重试策略的最大次数符合预期。

5. 触发的异常不在重试范围内 #

如果测试中抛出的异常不在RetryTemplate的重试异常列表中，重试逻辑不会执行，自然也不会走到恢复块：

• 检查重试策略的异常匹配规则，比如SimpleRetryPolicy默认只重试RuntimeException，如果抛出的是CheckedException，需要在配置中显式添加该异常类型到retryableExceptions。

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