Spring Boot应用中非Bean类使用RetryTemplate不生效问题求助

1. 校验RetryTemplate实例化与配置正确性 #

• 确认OAuthRestClient中的RetryTemplate是已完成初始化的单实例，不要每次调用execute方法时都重新builder生成新的RetryTemplate，否则重试状态会被重置无法计数。
• 检查重试策略配置是否正确，尤其是根因遍历逻辑：如果你的异常是被HTTP客户端的包装异常包裹的，要确保你配置的SimpleRetryPolicy/ExceptionClassifierRetryPolicy开启了根因遍历，参考配置示例：

SimpleRetryPolicy retryPolicy = new SimpleRetryPolicy(
    2, // 注意此处为总调用次数：1次初始调用+1次重试，如需重试2次要配置为3
    Collections.singletonMap(Exception.class, true),
    true // 必须开启该参数才会遍历异常根因匹配
);

• 确认最大尝试次数语义符合预期：Spring Retry的maxAttempts是总调用次数，不是重试次数，配置为2时只会重试1次。

2. 校验异常抛出链路是否符合预期 #

• 确认executeRequest方法抛出的异常没有被内部try-catch吞掉，必须直接抛出到retryTemplate.execute的回调方法外层，才能被重试策略捕获。
• 确认InternalServerError/BadGatewayError对应的HTTP状态码会被客户端直接转换为异常抛出，而不是返回包含错误状态码的Response对象，无异常抛出场景不会触发重试。

3. 校验RetryTemplate的调用逻辑是否正确 #

• 确认executeRequest的调用完全包裹在RetryCallback回调内部，不要写在retryTemplate.execute方法外，正确调用示例：

public <T> T execute() {
    // 所有业务逻辑必须放在回调内部
    return retryTemplate.execute(context -> executeRequest());
}

• 如果OAuthRestClient是多实例实现，确认每个实例持有的RetryTemplate都完成了正确配置，不会出现配置未生效的实例。

4. 快速调试手段 #

• 给RetryTemplate添加RetryListener，在onError方法中打印重试计数、捕获到的异常信息，快速定位是异常未被捕获还是重试计数未累加的问题。
• 临时将重试策略调整为对所有Throwable都重试，排除异常类型匹配问题。

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