500과 503 구분 통한 API 장애 복구 전략 및 클라이언트 재시도 최적화

Context

서버 측 오류 발생 시 범용적인 5xx 응답만으로 처리함에 따른 클라이언트 대응 전략 부재. 오류의 일시성 여부를 구분하지 못해 불필요한 재시도로 인한 서버 부하 가중 및 디버깅 효율 저하 발생.

Technical Solution

• 예기치 못한 Runtime Exception 및 로직 버그 처리를 위한 500 Internal Server Error 할당으로 개발자 개입 필요성 명시
• 서버 과부하 및 정기 점검 등 일시적 상태를 나타내는 503 Service Unavailable 설계를 통한 시스템 가용성 상태 전달
• 503 응답 시 Retry-After 헤더를 포함하여 클라이언트의 지수 백오프(Exponential Backoff) 및 재시도 시점 제어
• 보안 강화를 위해 500 응답 시 내부 스택 트레이스를 은닉하고 정제된 Generic Message만 노출하는 구조 설계
• 500 오류의 내부 로깅 및 즉각적인 Alert 시스템 연결을 통한 평균 복구 시간(MTTR) 단축 도모