tool::http-status-detail

503 Service Unavailable

The server is temporarily unable to handle the request.

상태 코드

503

이름

Service Unavailable

카테고리

5xx

상세 설명

HTTP 503 Service Unavailable은 서버가 일시적으로 요청을 처리할 수 없음을 나타냅니다. 과부하, 유지보수, 또는 의도적인 다운타임이 원인입니다. 502와 달리 서버 자체는 정상이지만 현재 서비스 제공이 불가능한 상태입니다. Retry-After 헤더를 통해 클라이언트에게 언제 다시 시도할지 알려줄 수 있습니다.

주요 원인

▸서버 유지보수 또는 계획된 다운타임
▸트래픽 급증으로 인한 서버 과부하
▸Rate limiting에 의해 요청이 거부된 경우
▸백엔드 의존성(DB, 외부 API)이 응답하지 않는 경우
▸배포 중 서버 재시작 구간

해결 방법

1.Retry-After 헤더가 있다면 해당 시간 후 재시도하세요
2.서버 리소스를 확인하고 필요시 스케일업/아웃하세요
3.로드 밸런서를 사용하여 트래픽을 분산하세요
4.유지보수 중이라면 사용자에게 예상 복구 시간을 안내하세요
5.Auto-scaling을 설정하여 트래픽 급증에 자동 대응하세요

응답 예시

HTTP/1.1 503 Service Unavailable
Retry-After: 300
Content-Type: application/json

{"error":"service_unavailable","message":"Server is under maintenance. Please retry after 5 minutes."}

503 Service Unavailable

상세 설명

관련 HTTP 헤더

응답 예시

관련 상태 코드