🌱 Spring Retry : 외부 API 장애에 강한 서비스 만들기

외부 시스템과 통신할 때, 간헐적으로 장애가 발생하는 경우가 있다.

한 번 실패했다고 바로 에러를 반환해버리면 사용자 경험은 물론 시스템 신뢰성에도 문제가 생길 수 있따...ㅜㅜ

이런 상황을 해결하기 위한 자동 재시도(Retry) 기능, spring-retry를 알아보쟈!

👀 Spring Retry란

: 특정 작업이 실패했을 때 자동으로 정해진 횟수만큼 재시도하는 기능을 제공하는 Spring 기반의 라이브러리

언제 쓰면 좋을까?

1. 외부 API 일시적 오류가 생겼을 때 (서버가 일시적으로 죽었거나 타임아웃 발생 시)

2. DB/Redis 연결 끊김 (네트워크 문제로 접속이 안 되는 경우)

3. 결제, 인증 서비스 호출 (외부 연동 실패 시 복구 시도)

위와 같은 문제점이 생겼을 때, Spring Retry를 쓰면

• 일시적인 오류 복구: 재시도로 한 번의 실패를 극복
• 사용자 경험 향상: 즉시 실패 대신 재시도 후 성공 가능
• 비즈니스 로직 단순화: 복잡한 예외/재시도 로직을 어노테이션으로 처리
• Fallback 처리 지원: 모든 재시도 실패 시 대체 로직 실행 가능

이러한 장점이 생긴다!

🔎 적용해보기

1. gradle 의존성 추가 + 메인 실행 클래스

implementation 'org.springframework.retry:spring-retry'
implementation 'org.springframework.boot:spring-boot-starter-aop'

spring retry는 AOP기반이기 때문에 해당 의존성도 추가해주어야한다.

또한 반드시!! 메인 실행되는 클래스에
@EnableRetry를 추가해주어야한다

@SpringBootApplication
@EnableRetry
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

2. @Retryable(~) + @Recover

너 몇 번까지 실패해도 돼? 를 @Retryable로 설정하고
만약 다 실패했을때 사용자에게 피드백을 제공해주고 싶으면 짝꿍으로 @Recover를 사용해주면 된다.

비즈니스 로직에 적용해보자

@Service
public class ExternalApiService {

    @Retryable(
        value = { RuntimeException.class },//다른 에러로 설정해도 됨
        maxAttempts = 3, //3번까지는 실패해도 봐줌 ㅋ
        backoff = @Backoff(delay = 2000) //재시도까지 걸리는 시간(2초)
    )
    public String callApi() {
        System.out.println("API 호출 시도...");
        throw new RuntimeException("외부 API 오류");
    }

요렇게하면 3번까지는 봐주다가 그게 넘어가면 에러를 보여주게 된다.
근데 이렇게 에러를 보여주는 것보다 사용자에게 어떤 피드백을 보여주고 싶다?

그럴떄 @Recover를 통해
위의 메서드에서 발생한 RuntimeException을 받아서 피드백이 실행된다

    @Recover
    public String recover(RuntimeException e) {
        log.error("모든 시도가 실패함. address: {}, error : {}", address, e.getMessage());    
    return null;    
    }
}