홈 › HTTP 상태 코드
503 Service Unavailable 오류 뜻과 해결 방법
하이퍼텍스트 전송 프로토콜(HTTP) 503 Service Unavailable 서버 에러 응답 코드는 서버가 요청을 처리할 준비가 되지 않은 것을 의미합니다.
이 코드는 서버가 요청을 처리할 준비가 되어 있지 않다는 뜻의 서버 오류(5xx) 응답입니다. 유지보수로 서버가 내려갔거나 과부하 상태인 것이 흔한 원인이며, 일시적인 상황에 쓰는 응답입니다.
어디서 나오나: 웹사이트 접속·API 호출 응답으로
해결 순서
응답에 Retry-After 헤더가 있다면 거기 적힌 서비스 복구 예상 시간이 지난 뒤 다시 시도하세요. [원문]

운영자라면 503 응답에 서비스 복구 예상 시간을 담은 Retry-After 헤더를 가능한 한 넣으세요. [원문]
운영자라면 503 응답과 함께 문제를 설명하는 사용자 친화적 페이지를 보내세요. [원문]
운영자라면 503 응답에 붙는 캐시 관련 헤더에 주의하세요. 503은 일시적 문제이므로 응답이 캐시되면 문제를 고친 뒤에도 클라이언트가 옛 오류 페이지를 받을 수 있습니다. [원문]
운영자라면 유지보수 중에는 모든 트래픽을 503 페이지로 임시 라우팅할 수 있습니다. 소프트웨어 업데이트 중에 자동으로 이렇게 되기도 합니다. [원문]
운영자라면 특정 클라이언트의 요청을 속도 제한으로 막는 경우에는 503이 아니라 429 Too Many Requests로 응답하세요. [원문]
공통 절차: HTTP 상태 코드 한눈에
그래도 안 될 때
과부하 상황에서는 메모리·CPU·연결 풀 한도에 이르렀을 때 서버 측 애플리케이션이 503으로 요청을 거절합니다. 서버 자원이 소진되어 더 심한 장애로 번지는 것을 막기 위한 동작입니다.
같은 오류의 다른 표기
아래 표기로 검색해도 이 페이지가 나옵니다.
- 상수Service Unavailable