TechFeedTechFeed
503서버 오류(5xx)

503 Service Unavailable — 서비스 일시 불가

서버가 일시적으로 요청을 처리할 수 없다는 응답입니다. 과부하·점검·콜드스타트 등 일시적 상태를 뜻합니다.

언제 발생하나

트래픽 폭주로 인한 과부하, 배포·점검 중, 의존 서비스(DB) 다운, 헬스체크 실패에서 발생합니다.

실무 대응

  1. Retry-After 헤더가 있으면 그만큼 기다렸다 재시도합니다.
  2. 과부하면 오토스케일·캐시·레이트리밋으로 부하를 분산·완화합니다.
  3. 의존 서비스(DB·외부 API) 상태를 확인합니다.
💡 실무 메모: 503은 일시적이라는 의미라 검색엔진도 잠시 후 재방문합니다. 점검 시 503 + Retry-After가 올바른 신호입니다.

관련 코드·에러

관련 가이드

REST API 설계 체크리스트 2026 — 엔드포인트 네이밍부터 에러 응답까지 실무 35항목