📖 개요

• Circuit Breaker
  마이크로서비스 간 호출 실패를 감지하고 시스템 장애 전파를 차단하는 패턴

• 왜 사용하는지
  서비스 간 호출 실패가 연쇄적으로 발생하는 문제 방지
  외부 API 장애로 전체 시스템 다운되는 상황 방지

• 해결하는 문제

• 장애 전파 방지

• 빠른 실패 처리

• 시스템 안정성 확보

• Resilience4j
  CircuitBreaker 구현 라이브러리
  실패율 기반 상태 관리 및 fallback 제공

---

⚙️ 핵심 개념

1️⃣ CircuitBreaker 추상화 vs 구현체

Spring Cloud CircuitBreaker

• 추상화 계층 제공
• 다양한 구현체 선택 가능

예시

• Resilience4j
• Hystrix (deprecated)
• Sentinel 등

❗ 특징

• starter 사용 시 구현체 포함되지 않음
• 내부적으로 인터페이스만 제공

👉 실제 동작 위해 구현체 필요

---

2️⃣ Resilience4j 직접 사용

현재 프로젝트 방식

• Spring Cloud starter 사용 ❌
• Resilience4j 라이브러리 직접 추가

implementation 'io.github.resilience4j:resilience4j-spring-boot3:2.2.0'

📌 이유

• 추상화 없이 직접 제어 가능
• 설정 명확
• 디버깅 용이

---

3️⃣ CircuitBreaker 상태 관리

• Closed → 정상 호출
• Open → 호출 차단
• Half-Open → 일부 요청 테스트

📌 상태 흐름

Closed → Open → Half-Open → Closed

👉 실패율 기반 자동 전환

---

4️⃣ Fallback

• 외부 호출 실패 시 대체 로직 실행
• 사용자에게 안정적인 응답 제공

@CircuitBreaker(name = "productService", fallbackMethod = "fallback")
public String call() {
    return externalService.call();
}

public String fallback(Throwable t) {
    return "fallback";
}

👉 장애 상황에서도 서비스 유지 가능

---

5️⃣ LLM 사용 시 주의 (중요)

LLM (예: GPT)

• 환각(Hallucination) 발생 가능
• 항상 정확한 정보 보장 불가

📌 대응 방법

• 공식 문서 확인 필수
• 구글 검색 재검증
• 코드 실행으로 검증

👉 LLM 결과 = 참고용
👉 실제 적용 전 검증 필수

---

🔍 동작 원리

CircuitBreaker 흐름

Client → Service → External API

정상

Client → Service → External API → Success

장애 발생

Client → Service → External API → Fail
→ 실패율 증가
→ Circuit Open

이후

Client → Service → ❌ External 호출 차단
→ Fallback 실행

---

상태 변화 흐름

요청 → 실패 누적 → 임계값 초과
→ Open 상태 전환
→ 일정 시간 후 Half-Open
→ 성공 시 Closed 복귀

---

💻 코드 예시

1️⃣ 의존성 추가

dependencies {
    implementation 'io.github.resilience4j:resilience4j-spring-boot3:2.2.0'
    implementation 'org.springframework.boot:spring-boot-starter-aop'
}

---

2️⃣ Service 적용

@Service
public class ProductService {

    @CircuitBreaker(name = "productService", fallbackMethod = "fallback")
    public String getProduct(String id) {
        if ("111".equals(id)) {
            throw new RuntimeException("error");
        }
        return "product " + id;
    }

    public String fallback(String id, Throwable t) {
        return "fallback product " + id;
    }
}

---

3️⃣ application.yml 설정

resilience4j:
  circuitbreaker:
    configs:
      default:
        slidingWindowType: COUNT_BASED
        slidingWindowSize: 5
        minimumNumberOfCalls: 5
        failureRateThreshold: 50
        waitDurationInOpenState: 20s

---

🚀 사용 사례

• 외부 결제 API 호출 보호
• 상품 서비스 → 재고 서비스 호출 보호
• FeignClient 호출 안정성 확보
• 장애 발생 시 fallback 데이터 제공

---

🧠 TIL (Today I Learned)

• Spring Cloud CircuitBreaker는 추상화 계층 제공
• starter 사용 시 구현체 포함되지 않음
• Resilience4j 직접 추가하여 사용 가능
• CircuitBreaker는 장애 전파 방지 핵심 패턴
• LLM 결과는 반드시 검증 후 사용 필요