홈 › 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 HTTP 503 하이퍼텍스트 전송 프로토콜(HTTP) 503 Service Unavailable 서버 에러 응답 코드는 서버가 요청을 처리할 준비가 되지 않은 것을 의미합니다.