本文介绍一种基于 Supplier 的泛型重试封装方案，使任意 JPA Repository 方法（如 findById、findByNumber）均可被 @Retryable 统一增强，兼顾类型安全与调用简洁性。
本文介绍一种基于 `supplier
在 Spring 生态中，@Retryable 是实现容错重试的经典注解（通常配合 spring-retry 使用），但其作用目标必须是被 Spring 代理的方法——这意味着直接在当前 Service 类内部调用 @Retryable 方法将失效（与 @Transactional 同理，受限于 Spring AOP 的代理机制）。为解决这一限制，同时支持任意返回类型的 Repository 调用（如 Employee、Record 等），推荐采用以下泛型封装方式：
✅ 推荐方案：泛型 retry(Supplier<t>)</t> 方法
定义一个带 @Retryable 注解的公共重试入口方法，参数为 Supplier<t></t>，利用 Lambda 表达式延迟执行具体数据库操作：
@Service
public class RetryableService {
@Retryable(
value = {SQLException.class, RuntimeException.class},
maxAttempts = 3,
backoff = @Backoff(delay = 1000, multiplier = 2)
)
public <t> T retry(Supplier<t> supplier) {
return supplier.get();
}
// 可选：提供带 fallback 的重载方法（需配合 @Recover）
@Recover
public <t> T recover(Exception e, Supplier<t> supplier) {
log.warn("All retry attempts failed for operation: {}", supplier, e);
throw new DataAccessException("Operation failed after retries", e);
}
}</t></t></t></t>
✅ 正确调用方式（跨 Bean 调用）
确保 retry(...) 方法由 Spring 容器管理的另一个 Bean 调用（例如注入 RetryableService 到你的业务 Service 中）：
@Service
public class EmployeeService {
private final EmployeeRepository repository;
private final RetryableService retryService; // ← 注入外部重试服务
public EmployeeService(EmployeeRepository repository, RetryableService retryService) {
this.repository = repository;
this.retryService = retryService;
}
public Employee findEmployeeById(String id) {
return retryService.retry(() -> repository.findById(id)
.orElseThrow(() -> new EntityNotFoundException("Employee not found: " + id)));
}
public Record findRecordByNumber(int number) {
return retryService.retry(() -> repository.findByNumber(number));
}
}
⚠️ 关键注意事项
-
不可自调用：切勿在同一个类中直接调用
this.retry(...)，否则 AOP 代理不生效，重试逻辑将被跳过； -
异常需匹配：
@Retryable默认仅对未捕获的运行时异常重试；若 Repository 方法抛出受检异常（如自定义DataAccessException），需显式声明value = {YourException.class}； -
返回值空处理：
Optional<t></t>类型（如findById）建议在retry()外层做orElseThrow()或orElse(null)显式处理，避免空指针； -
事务兼容性：
@Retryable与@Transactional可共存，但需注意重试粒度——每次重试均为独立事务（Spring 默认传播行为为REQUIRED）。
该方案以最小侵入性实现了类型安全、可复用、符合 Spring AOP 规范的重试抽象，无需为每个查询方法重复编写 @Retryable，也无需定义冗余的函数式接口，是面向 JPA 场景的轻量级最佳实践。
