의미
과부하나 점검 때문에 서버가 일시적으로 요청을 처리할 수 없습니다. Retry-After가 다시 시도할 시점을 알려줄 수 있습니다.
흔한 원인
- 계획된 점검
- 서버 과부하 또는 워커 부족
- 오토스케일링 지연이나 의존 서비스 장애
해결 방법
클라이언트 또는 방문자라면
Retry-After를 지켜 나중에 재시도하세요.
사이트나 API 운영자라면
점검 중에는 Retry-After를 보내고, 용량을 늘리며, 부하를 우아하게 줄이세요. 검색 엔진은 짧은 503을 일시적인 것으로 봅니다.
응답 예시
HTTP/1.1
HTTP/1.1 503 Service Unavailable
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Retry-After: 120
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Service Unavailable",
"status": 503,
"detail": "Down for maintenance until 02:00 UTC."
}명세
자주 묻는 질문
› 점검 페이지에 503이 적합한가요?
네. Retry-After와 함께 503을 반환하면 검색 엔진이 페이지가 사라졌다고 보지 않고 색인을 유지합니다.
› 503과 500의 차이는?
503은 중단이 일시적이며 회복될 것임을, 500은 예상치 못한 실패를 뜻합니다.