503 Service Unavailable이 보여요

“503 오류”, “서비스 이용 불가”, “사이트가 잠시 멈췄어요”처럼 검색하는 상황에서 사용합니다. HTTP 503은 서버가 현재 요청을 처리할 수 없다는 응답이지만, 웹서버·프록시·애플리케이션·유지보수 화면 중 어느 구간에서 발생했는지는 상태 코드만으로 확정할 수 없습니다.

먼저 기록할 것

1. 요청 URL, HTTP 메서드, 실제 응답 상태, 응답 본문·헤더, 발생 시각을 기록합니다.
2. 화면 문구와 브라우저 개발자 도구의 Network 상태가 같은지 비교합니다.
3. 응답 헤더에 Retry-After 또는 요청 식별자가 있으면 값과 확인 시각을 기록합니다. 토큰·쿠키·개인정보는 제거합니다.
4. 최근 배포·서버 재시작·점검·용량 변경·프록시 변경을 발생 시각과 함께 기록합니다.

관찰값별 다음 단계

관찰값	판정	다음 문서
실제 HTTP 응답이 503 Service Unavailable	서버가 현재 요청을 처리할 수 없는 상태입니다. 원인 구간을 로그로 나눠 확인합니다.	HTTP 503: Service unavailable
화면에는 503이지만 실제 응답 상태가 다르거나 확인되지 않음	오류 화면과 네트워크 응답이 서로 다른 구간에서 생성됐을 수 있습니다.	화면 문구와 실제 HTTP 상태 불일치
특정 경로·메서드에서만 재현	전체 서비스 장애로 단정하지 않고 요청 경로·메서드·애플리케이션 로그를 비교합니다.	해당 경로의 Problem 또는 서버 로그 확인

상태 코드가 같아도 원인은 환경마다 다를 수 있습니다. Retry-After가 있다고 해서 애플리케이션이 자동으로 정상화된다고 단정하지 않으며, 재시도 폭주를 만들지 않도록 담당자의 재시도 기준을 확인합니다.

수정 후 재확인

1. 변경 전 503 응답의 URL·메서드·시각을 보관합니다.
2. 원인이 확인된 한 구간만 변경하고, 서버·프록시·애플리케이션 로그를 같은 시각으로 확인합니다.
3. 최초에 실패한 요청과 정상 요청을 각각 반복해 상태 코드·응답 시간·응답 주체를 비교합니다.
4. 화면만 정상으로 바뀌고 실제 API 응답이 503인 경우에는 해결로 기록하지 않습니다.