Spring Boot中@Retryable注解不生效问题排查求助

核心问题：异常被捕获吞掉，重试机制无法触发 #

你的getProductMetadata方法中，调用restTemplate.getForEntity时捕获了所有Exception并直接返回null。Spring Retry的@Retryable是基于方法抛出的异常触发重试逻辑的，一旦你把异常捕获后不往外抛，重试机制就无法感知错误，自然不会执行重试。

修复方式： #

移除对restTemplate调用的try-catch包裹，或者在catch块中重新抛出异常：

// 方式1：移除try-catch，让异常直接抛出
ResponseEntity<String> response = restTemplate.getForEntity(endpoint, String.class);

// 方式2：需记录日志后抛出，保留catch但重新抛出异常
try {
    response = restTemplate.getForEntity(endpoint, String.class);
} catch (Exception ex) {
    String errorMsg = "getProductMetadata for sku: " + sku + " threw exception: " + ex.getMessage();
    HandlerResult.updateStatus(handlerResult, errorMsg, false);
    logger.info(++count + " Call attempts were made");
    throw ex; // 重新抛出异常，触发重试逻辑
}

额外问题：RestTemplate默认不抛出HTTP状态码异常 #

默认情况下，RestTemplate收到502这类非2xx的HTTP状态码时，不会自动抛出异常，仅返回包含错误状态码的ResponseEntity，这种情况也无法触发重试。需要配置RestTemplate的错误处理器，让它在遇到指定状态码时抛出异常：

配置RestTemplate示例： #

@Bean
public RestTemplate restTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.setErrorHandler(new DefaultResponseErrorHandler() {
        @Override
        protected boolean hasError(HttpStatus statusCode) {
            // 定义视为错误的状态码范围，比如5xx服务端错误、4xx客户端错误
            return statusCode.is5xxServerError() || statusCode.is4xxClientError();
        }
    });
    return restTemplate;
}

配置后，收到502等错误状态码时，RestTemplate会抛出HttpServerErrorException，进而触发重试。

其他优化点 #

• 调整@Retryable配置，将maxAttempts改为3（匹配你的需求），同时可以精确指定重试的异常类型，避免捕获所有异常：

@Retryable(retryFor = {HttpServerErrorException.class, IOException.class}, 
           maxAttempts = 3, 
           backoff = @Backoff(delay = 100))

• 实例变量count在多线程环境下会出现计数错误，建议改用AtomicInteger：

private AtomicInteger count = new AtomicInteger(0);
// 使用时
logger.info(count.incrementAndGet() + " Call attempts were made");

确认@EnableRetry配置 #

确保@EnableRetry注解添加在Spring Boot的启动类上（你提到已在主类添加，此步骤可快速验证）。

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