resilience-retry

Resilience and Retry (Boot 3)

Boot 3 には、Spring Framework 7 コアのレジリエンスアノテーションはありません。シンプルな命令型のリトライには Spring Retry を、サーキットブレーカー、レート制限、バルクヘッドも必要な場合は Resilience4j を選択してください。依存関係と設定は明示してください。

@Configuration
@EnableRetry
class RetryConfig { }

@Service
class PaymentClient {
    @Retryable(
        retryFor = ConnectException.class,
        maxAttempts = 4,
        backoff = @Backoff(delay = 200, multiplier = 2.0, maxDelay = 2000))
    PaymentResult charge(ChargeRequest request) { ... }

    @Recover
    PaymentResult recover(ConnectException error, ChargeRequest request) { ... }
}

Spring Retry の maxAttempts には初回の呼び出しも含まれます。リトライをサーキットブレーカーやバルクヘッドと組み合わせる必要がある場合は、Resilience4j が適しています。どちらの方法もプロキシベースです。自己呼び出しではアドバイスが適用されず、ロールバック専用のトランザクション内でメソッドをリトライしても、試行ごとに新しいトランザクションが作られるわけではありません。

注意点

• エージェントが Framework 7 の @EnableResilientMethods を使用します。Boot 3 では Spring Retry または Resilience4j が必要です。
• エージェントが maxAttempts をリトライ回数と混同します。Spring Retry では初回の呼び出しも含まれます。
• エージェントが Resilience4j に @Recover を追加します。リカバリーはフォールバックまたは呼び出し側の処理としてモデル化する必要があります。
• エージェントが自己呼び出しされるメソッドをリトライします。Spring プロキシ経由で呼び出してください。
• エージェントが新しいトランザクションを期待して、トランザクション内でリトライします。リトライをトランザクション対象の Bean の外に移してください。
• エージェントが冪等性キーなしで、冪等でない書き込みをリトライします。決済やコマンド操作を保護してください。