resilience-retry

name	resilience-retry
description	Use when adding retries, backoff, or concurrency limits to Spring Boot 4 / Spring Framework 7 code with core Retryable and ConcurrencyLimit support. Covers enablement, backoff, proxy limits, and behavior after retries are exhausted.

Core Resilience (Boot 4 / Framework 7)

Spring Framework 7 provides core declarative retry and concurrency limiting. This is not a repackaging of the separate spring-retry project; attribute names and recovery behavior differ.

Enable resilient methods

@Configuration
@EnableResilientMethods
class ResilienceConfig { }

Use @Retryable for transient failures and @ConcurrencyLimit as a lightweight bulkhead:

@Service
class PaymentClient {
    @Retryable(
        includes = ConnectException.class,
        maxRetries = 4,
        delay = 200,
        multiplier = 2.0,
        maxDelay = 2000,
        jitter = 50)
    PaymentResult charge(ChargeRequest request) { ... }
}

@ConcurrencyLimit(4)
Report generateReport(UUID id) { ... }

maxRetries counts retries after the first call, so four retries means five total attempts. Backoff attributes are flat on @Retryable; multiplier = 1.0 means fixed delay.

Core resilience has no @Recover. When attempts are exhausted, the last exception reaches the caller. Catch it at the orchestration boundary or use a listener. Because the implementation is proxy-based, self-invocation bypasses advice. Put retry outside a transactional bean when each attempt needs a fresh transaction.

Gotchas

• Agent adds spring-retry for basic core retry - use @EnableResilientMethods with Framework 7.
• Agent imports org.springframework.retry.annotation - core annotations use org.springframework.resilience.annotation.
• Agent writes maxAttempts - core uses maxRetries, which counts retries rather than total calls.
• Agent adds @Recover - core resilience has no recovery callback; handle the final exception at the caller.
• Agent nests @Backoff - use flat delay, multiplier, maxDelay, and jitter attributes.
• Agent forgets @EnableResilientMethods - annotations are ignored without enablement.
• Agent retries a self-invoked method - call through a Spring proxy.
• Agent retries inside a rollback-only transaction - move retry outside the transactional boundary.